Python 依赖管理新选择:uv 入门实战
一、为什么需要新的依赖管理工具
Python 开发者对 pip 加 venv 的组合再熟悉不过:新建虚拟环境、逐个安装依赖、手动维护 requirements.txt。项目一多,问题就来了:安装慢、依赖冲突难定位、不同项目的环境容易互相污染。更麻烦的是,requirements.txt 只记录版本号,换一台机器复现环境时常常出现“在我电脑上能跑”的尴尬。
uv 是 Astral 团队用 Rust 编写的 Python 包管理工具,目标是把安装、解析和环境管理做得更快、更可靠。它兼容 pip 的命令习惯,同时把项目管理、工具安装、虚拟环境管理收拢到一个命令里。
二、安装与初体验
在 macOS 和 Linux 上可以用官方安装脚本一键安装,Windows 上可以用 PowerShell 安装。装好后执行 uv --version,能看到版本号就说明成功。建议先执行 uv python install 3.12,装一个由 uv 管理的解释器,不同项目可以用不同版本,互不干扰。
和 pip 相比,uv 安装依赖的速度提升非常明显:Rust 实现的并行下载与解析,加上全局缓存,让第二次安装相同依赖几乎是秒完成。
三、用 uv 管理一个项目
进入项目目录执行 uv init,会生成 pyproject.toml 和示例 main.py。再执行 uv add requests,uv 会自动创建 .venv 虚拟环境、把 requests 写入 pyproject.toml,并生成 uv.lock 锁定文件。这个文件记录了每个依赖的精确版本和哈希值,提交到版本库后,团队成员就能安装出完全一致的环境。
运行代码不需要手动激活虚拟环境:uv run main.py 会自动使用项目虚拟环境;添加开发依赖用 uv add --dev pytest,删除依赖用 uv remove requests。需要临时试用某个包时,uvx ruff check . 可以直接运行而不安装到任何环境,用完即走。
四、从 pip 迁移的注意事项
已有 requirements.txt 的项目,可以先用 uv pip install -r requirements.txt 平滑过渡,再逐步迁移到 pyproject.toml。注意两点:uv 的缓存会随项目增多而变大,定期执行 uv cache prune 清理;锁定文件要提交到版本库,.venv 目录不要提交。
结语:uv 不是要取代 Python 生态,而是把散落在 pip、venv、pip-tools 里的能力收拢成一个又快又稳的工具。从 uv init 和 uv add 开始,十分钟就能感受到依赖管理变轻的感觉。
- 点赞
- 收藏
- 关注作者
评论(0)