UV 是专为 Windows 打造的一款“命令行级”软件管家。
它只给你两个文件:uv.exe 和 uvx.exe,加起来不到 20 MB,扔进任意目录就能干活。
把这一目录写进 PATH,之后无论在 PowerShell、CMD 还是 Windows Terminal,只需敲一行字就能装、卸、更新、搜索任何包——体验跟 Linux 的 apt 一样丝滑,却完全原生,不依赖 WSL、虚拟机或 MSYS。
uv.exe 负责日常:uv install python@3.12uv upgrade nodeuv list --outdateduv uninstall rust
uvx.exe 则是“临时沙盒”:uvx ffmpeg -i input.mp4 output.gif
它会自动拉取最新版 FFmpeg,执行完就把临时环境删掉,不污染系统。
没有 GUI,也就没有了“下一步”狂点;没有注册表,卸载就是字面意义上的“删除”。
所有包都躺在 %USERPROFILE%.uv\cache,想清缓存直接 uv cache purge,一键归零。
对开发者更友好:
- 支持多版本并存,
uv use python@3.8与uv use python@3.12秒级切换; - 项目级锁文件 uv.lock,保证队友拉到的是同一组二进制;
- 内置依赖图解析,冲突提前报错,不会把 DLL 地狱带到生产环境。
升级自身也只要uv self-update,不到 3 秒完成,无需重启终端。
官方文档只有一页 Cheatsheet,社区把常用包做成了 5 秒复制的“一行命令”片段。
出了问题,开一条 Issue,通常当天就能收到回复——因为整个项目用 Rust 写成,源码就在 GitHub,调试起来比 PowerShell 脚本爽快得多。
一句话:
想在 Windows 上像 Linux 一样“命令行装软件”,又懒得折腾 Chocolatey 的 XML、Scoop 的 JSON,就把 UV 扔进 PATH,从此uv install走天下。
下面给出「最简 3 步」在 Windows 上把 UV 跑起来,并验证成功的全过程。
全程无需管理员权限,Win10/11 均适用。
1. 下载 & 解压(30 秒)
- 浏览器打开 GitHub Release 页
https://github.com/astral-sh/uv/releases
找到最新版uv-x86_64-pc-windows-msvc.zip(一般 10 MB 左右)。 - 把 zip 解压缩到 不含有空格 的目录,建议:
C:\tools\uv
解压后应该能看到 2 个文件:C:\tools\uv\uv.exe C:\tools\uv\uvx.exe
2. 写进 PATH(1 分钟)
*方法 A 解压后将uv.exe复制到任意目录(如D:\tools\uv),
通过以下步骤手动添加路径到系统环境变量:
右键“此电脑”→“属性”→“高级系统设置”→“环境变量”;
在“系统变量”中找到Path,点击“编辑”→“新建”,输入文件所在路径(如D:\tools\uv),重启命令行工具生效。
方法 B – 临时生效(只想先试试)*
打开 PowerShell,执行
$env:PATH += ";C:\tools\uv"
关掉窗口就失效。
方法 C – 永久生效(推荐)
继续在 PowerShell 里执行一次:
[Environment]::SetEnvironmentVariable(
"PATH",
$env:PATH + ";C:\tools\uv",
"User" # 对当前用户生效,无需管理员
)
重新打开一个终端,让 PATH 刷新。
3. 验证 & 基本用法(10 秒)
uv --version # 看到类似 uv 0.5.1 字样即成功
uvx --version # 同上
顺手装个常用工具体验:
uvx cowsay "Hello UV"
第一次会自动拉取 cowsay,执行完即把临时环境删掉,系统保持干净。
可选:配置国内镜像(加快下载)
在 PowerShell 执行一次即可写入用户环境变量:
[Environment]::SetEnvironmentVariable("UV_INDEX_URL", "https://pypi.tuna.tsinghua.edu.cn/simple", "User")
(UV 同时支持 PyPI 与二进制包,该变量对 Python 包生效最快。)
卸载(30 秒)
- 把
C:\tools\uv整个目录删掉; - 在「系统属性 → 环境变量」里把刚才追加的
;C:\tools\uv从 PATH 移除即可。
无注册表、无残留,真正的“绿色卸载”。
完成!
现在你就可以在任何路径下uv install python@3.12uvx ffmpeg -i input.mp4 output.gif
像 Linux 一样玩转 Windows 软件了。