Python 依赖管理新选择:uv 入门实战

举报
yd_252022162 发表于 2026/11/13 06:13:08 2026/11/13
【摘要】 一、为什么需要新的依赖管理工具Python 开发者对 pip 加 venv 的组合再熟悉不过:新建虚拟环境、逐个安装依赖、手动维护 requirements.txt。项目一多,问题就来了:安装慢、依赖冲突难定位、不同项目的环境容易互相污染。更麻烦的是,requirements.txt 只记录版本号,换一台机器复现环境时常常出现“在我电脑上能跑”的尴尬。uv 是 Astral 团队用 Rus...

一、为什么需要新的依赖管理工具

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 开始,十分钟就能感受到依赖管理变轻的感觉。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。