1. 为什么你需要关注 uv:一个 Python 开发者的效率革命
如果你还在用 pip 和 virtualenv 管理 Python 项目,每次创建环境、安装依赖都要等上半天,尤其是在 CI/CD 流水线里,看着进度条慢悠悠地走,心里是不是有点着急?或者,你有没有遇到过“在我机器上好好的,怎么到服务器上就报错了”这种经典的“依赖地狱”问题?这些问题,我过去十年在 AI 模型和硬件项目里几乎天天碰到,直到我开始用 uv。
简单来说,uv 是一个用 Rust 写的、快得离谱的 Python 包管理和项目工作流工具。它把 pip、virtualenv、pip-tools、甚至 pyenv 的部分功能都打包在了一起,让你用一个命令行工具就能搞定所有事。我第一次用它给一个中型机器学习项目安装依赖,原本 pip 需要好几分钟的解析和下载,uv 十几秒就搞定了,那种感觉就像把老爷车换成了跑车。
它特别适合这几类人:新手开发者,因为它命令直观,能帮你从一开始就建立规范的项目结构;团队协作的工程师,因为它通过锁文件确保所有人的环境一模一样;需要频繁构建环境的 DevOps 或算法工程师,它的速度能极大缩短 CI/CD 的等待时间。说白了,无论你是写一个简单的 Web 后端,还是折腾复杂的 AI 模型训练环境,uv 都能让你花在“等待”和“排错”上的时间大大减少。
Astral 团队(就是做出那个超快的 Python 代码格式化工具 Ruff 的团队)出品,保证了它的质量和性能。接下来,我就带你从零开始,手把手把 uv 用起来,从安装配置到把一个真实项目部署上线,把每个环节的细节和可能遇到的“坑”都讲清楚。
2. 第一步:快速安装与初次配置
安装 uv 的过程非常简单,几乎不会遇到什么障碍。官方提供了几种方式,我个人最推荐的是使用官方安装脚本,它最省心,能自动处理路径配置。
2.1 跨平台安装命令
打开你的终端(Windows 用户请用 PowerShell 或 Windows Terminal),根据你的系统选择一行命令执行即可。
对于 macOS 或 Linux 用户,直接运行:
curl -LsSf https://astral.sh/uv/install.sh | sh
这行命令会下载安装脚本并自动执行。安装完成后,通常需要新开一个终端窗口,或者执行一下 source ~/.bashrc(或 source ~/.zshrc),这样 uv 命令就可以全局使用了。
对于 Windows 用户,在 管理员身份运行的 PowerShell 里执行:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
这里 -ExecutionPolicy ByPass 是为了允许执行远程脚本,irm 是 Invoke-RestMethod 的别名,用于下载脚本,iex 是 Invoke-Expression 的别名,用于执行。运行后,uv 会自动添加到你的系统 PATH 中。
还有一种更“Pythonic”的安装方式,如果你系统里已经有 pipx(一个用于安装和管理 Python 命令行应用的工具),那么用 pipx 安装是隔离性最好的选择:
pipx install uv
如果以上方法都失败了,最后的手段才是使用 pip:
pip install uv
但我不太推荐直接用 pip 装,因为这可能会和你现有的 Python 环境产生冲突。用官方脚本或 pipx 是更干净的做法。
安装完成后,马上验证一下:
uv --version
如果能看到版本号(比如 uv 0.4.x),恭喜你,安装成功了!我第一次看到这个输出时,感觉一个强大的新工具已经准备就绪了。
2.2 关键配置:让下载速度飞起来
安装只是开始,配置才是让 uv 发挥全部实力的关键。默认情况下,uv 会从 Python 官方的 PyPI 仓库下载包,对于国内用户来说,速度可能不太理想。我们需要把它换成国内的镜像源,比如阿里云或者清华源。
配置 uv 的镜像源有两种主流方法,我两种都用过,你可以根据习惯选择。
方法一:通过命令行参数临时指定。这在你想快速尝试某个源时很方便。
uv add requests --index-url https://mirrors.aliyun.com/pypi/simple/
或者用 -i 这个简写:
1641



被折叠的 条评论
为什么被折叠?



