查看: 167|回复: 3

uv替代pip与venv:Python依赖锁定和虚拟环境管理实战

[复制链接]
发表于 1 小时前 | 显示全部楼层 |阅读模式
uv 替代 pip 与 venv:Python 依赖锁定和虚拟环境管理实战

如果你长期做 Python 开发,下面几个场景大概率不陌生:克隆一个新仓库,执行 pip install -r requirements.txt 要等好几分钟,回来一看却是依赖冲突报错;在 A 项目里调通的代码,切到 B 项目就跑不起来,原因是全局环境里某个包被悄悄升级了;用 virtualenv 手动创建、激活、退出虚拟环境,步骤琐碎且容易忘。

这些问题的根源在于 Python 官方工具链 pip + venv 在速度、一致性和易用性上已经跟不上现代开发节奏。uv 是 Astral 团队(Pydantic 和 Rye 的作者)用 Rust 编写的 Python 包与项目管理工具,可一站式替代 pip、venv、pip-tools、pyenv,官方给出的依赖安装速度量级是 pip 的 10 到 100 倍。本文围绕命令行实操,梳理从安装、版本管理、包管理到项目迁移的完整用法。

一、先理解虚拟环境:隔离的实质是什么

直接用 pip install 装包时,包会进入全局目录,系统中所有 Python 项目共用同一份。例如先为项目 philosophers-stone 安装 harry==1,之后又为项目 prisoner-of-azkaban 安装 harry==3,后者会覆盖前者,第一个项目随即无法运行。

虚拟环境做的事很直接:在每个项目里建立一个独立目录(通常是 .venv),其中放一份专属的 Python 解释器和包。激活之后,系统优先使用这个目录里的 Python 与包。激活的实质,是把 .venv/bin(Windows 下为 .venv\Scripts)加到 PATH 环境变量的最前面。

正确做法是“一个项目一个 .venv”,但传统方式体验不佳:创建慢、激活繁琐、与 pyenv 各管各的、锁定依赖还要额外引入 pip-tools。uv 的价值就是把这些散落环节统一起来。

二、uv 能替代哪些工具

对照关系可以整理成下面几行,便于记忆迁移:
  1. venv / virtualenv        ->  uv venv
  2. pip install/uninstall/list ->  uv pip install/uninstall/list
  3. pip-compile / pip-sync     ->  uv pip compile / uv pip sync
  4. pyenv                      ->  uv python install / uv python pin
复制代码

除此之外,uv 还提供以 pyproject.toml 为中心的项目管理命令:uv init、uv add、uv sync、uv lock,让依赖声明与锁定进入规范化流程。它的几个核心特性是:Rust 实现的依赖解析器与下载引擎带来数量级的速度提升;分发的是单个可执行文件,没有 Python 依赖嵌套;通过 uv.lock 锁文件保证团队与 CI/CD 环境安装的版本完全一致;兼容 requirements.txt、pyproject.toml 等标准文件,迁移成本低;内置 Python 版本管理,无需另装 pyenv。

三、安装 uv

macOS / Linux 使用官方脚本安装,Windows 在 PowerShell 中执行对应脚本,macOS 也可以用 Homebrew:
  1. curl -LsSf https://astral.sh/uv/install.sh | sh
  2. # Windows PowerShell
  3. irm https://astral.sh/uv/install.ps1 | iex
  4. # macOS Homebrew
  5. brew install uv
复制代码

安装完成后验证:
  1. uv --version
  2. # 输出类似:uv 0.8.14 (Homebrew 2025-08-28)
复制代码

四、用 uv 管理 Python 版本

内置的版本管理省掉了 pyenv 这一层。uv python list 查看可用版本,uv python install 安装指定版本,uv python pin 为当前项目固定版本并生成 .python-version 文件:
  1. uv python list
  2. uv python install 3.12
  3. uv python pin 3.12
复制代码

五、创建与激活虚拟环境

创建默认名为 .venv 的环境,也可以指定解释器版本;激活方式与传统 venv 一致:
  1. uv venv
  2. uv venv --python 3.12
  3. # macOS / Linux
  4. source .venv/bin/activate
  5. # Windows PowerShell
  6. .venv\Scripts\activate
  7. deactivate
复制代码

需要提醒的是,在使用 uv run 的场景下,多数时候不必手动激活环境,uv 会自动定位正确的 .venv。

六、uv pip:与 pip 接口兼容的用法

uv pip 子命令与 pip 接口保持一致,原有的命令习惯可以直接沿用,只是把 pip 换成 uv pip:
  1. uv pip install requests
  2. uv pip install "requests==2.31.0"
  3. uv pip install -r requirements.txt
  4. uv pip install --upgrade requests
  5. uv pip uninstall requests
  6. uv pip list
  7. uv pip tree
  8. uv pip freeze > requirements.txt
复制代码

这一段最适合作为迁移的第一步:把脚本和文档中的 pip install 替换为 uv pip install,速度收益立刻可见,而行为语义不变。

七、依赖锁定与环境同步(pip-tools 模式)

这是最能体现确定性的两个命令。第一步定义顶级依赖,只写项目直接使用的包:
  1. # requirements.in
  2. fastapi
  3. uvicorn[standard]
  4. httpx
复制代码

第二步编译锁定文件,递归解析整棵依赖树,把每个包(含间接依赖)的精确版本与哈希写入 requirements.txt:
  1. uv pip compile requirements.in -o requirements.txt
复制代码

第三步同步环境:
  1. uv pip sync requirements.txt
复制代码

uv pip sync 与 pip install -r 有本质区别:它不只安装 requirements.txt 中的包,还会清理环境中多余的包,使环境状态与锁定文件严格一致;后者只安装不清理。日常维护流程因此固定为:增加依赖就编辑 requirements.in 再 compile、sync;删除依赖则先从 requirements.in 移除,再重新 compile、sync。

八、项目管理模式(长期项目推荐)

对需要长期维护的项目,建议使用以 pyproject.toml 为中心的模式。初始化后目录结构如下:
  1. uv init my_project
  2. cd my_project
  3. my_project/
  4. ├── pyproject.toml   # 项目配置与依赖声明
  5. ├── .python-version  # 固定的 Python 版本
  6. ├── README.md
  7. └── main.py
复制代码

添加依赖时,uv add 会自动更新 pyproject.toml 并生成或更新 uv.lock:
  1. uv add requests
  2. uv add "requests>=2.31.0"
  3. uv add --dev pytest ruff
  4. uv remove requests
复制代码

克隆项目后的一键安装使用 uv sync,它会依据 pyproject.toml 与 uv.lock 安装全部依赖,效果类似 pip install -r requirements.txt,但保证环境与锁文件严格一致。如果下载慢,可在 pyproject.toml 中配置国内镜像:
  1. [tool.uv]
  2. index-url = "https://pypi.tuna.tsinghua.edu.cn/simple"
复制代码

uv add 与 uv pip install 的差异可以用四个维度概括:前者会修改 pyproject.toml 与 uv.lock,后者不动配置文件;前者使用确定性锁文件,后者没有版本锁定;前者适合长期项目与团队协作,后者适合临时测试与全局工具安装;前者的虚拟环境会自动创建与同步,后者需要手动激活环境。

九、uv run:不激活环境也能跑脚本

uv run 会按项目环境执行命令,避免忘记激活环境、切错 Python 版本这类问题,在 CI/CD 与脚本自动化中尤其顺手:
  1. uv run main.py
  2. uv run pytest
  3. uv run python -c "import requests; print(requests.__version__)"
复制代码

一个典型的新项目起步流程是:uv init 初始化、uv python pin 固定版本、uv add 添加依赖、uv sync 同步环境、uv run 运行。团队新成员加入时只需 git clone、cd 进目录、uv sync 装好全部依赖、uv run main.py 直接运行。

十、从现有项目迁移的三条路径

只 有 requirements.txt 的项目:进入目录后先用 uv pip install -r requirements.txt 获得速度收益;若想锁定版本,则补一步 uv pip compile requirements.in -o requirements.txt 再 uv pip sync requirements.txt。

已有 pyproject.toml 的项目:直接 uv sync,uv 会自动识别并生成 uv.lock,之后的增删依赖与运行统一走 uv add 和 uv run。

从 pip + venv 迁移:原先需要 python -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt 三步,现在一条 uv sync 即可完成。

迁移的核心原则是渐进式切换:同一个项目里可以同时使用 pip 和 uv,先把 pip install 逐步替换为 uv pip install,最后再切到完整的 uv sync 工作流。uv 兼容现有 Python 包管理标准,不必担心两者冲突。

十一、几点使用结论

uv 并不是要推翻 Python 包管理生态,而是用更快、更统一的方式替换掉长期存在的“慢”与“散”。它兼容既有的 requirements.txt 与 pyproject.toml,迁移门槛低;同时提供 uv.lock、uv run、uv python 这类现代特性。个人开发者能少等安装、少踩环境不一致的坑;团队维护项目时,确定性构建可以让“在我机器上能跑”这类对话消失。记住四个高频命令即可上手:uv init 初始化项目,uv add 添加依赖并自动锁定,uv sync 一键安装全部依赖,uv run 免激活直接运行。
回复

使用道具 举报

发表于 1 小时前 | 显示全部楼层

Re: uv替代pip与venv:Python依赖锁定和虚拟环境管理实战

看完很有收获,尤其是那张工具对照表,把 venv、pip、pip-compile、pyenv 一条条对应到 uv 的子命令上,迁移时基本可以照着替换,不用重新建立一套心智模型。 我自己踩坑最多的是 uv pip sync 这块。以前习惯用 pip install -r 更新环境,但删掉的包其实还留在 site-packages 里,时间久了就出现本地能跑、CI 上装出来的环境却对不上的情况,sync 那种“多出来的就清掉”的语义正好治这个毛病。另外 uv run 不用手动 activate 也挺省心,在脚本和终端里调用时少了一步忘记激活的尴尬。 想请教一下后面被截断的那部分:如果项目里用 pyproject.toml 管依赖,uv add、uv lock、uv sync 这一套是不是就能完全覆盖 uv pip compile 的流程?我现在 requirements.in 和 pyproject 各留了一份,有点担心哪天两边对不上,不知道有没有必要统一到一种方式。
回复 支持 反对

使用道具 举报

发表于 1 小时前 | 显示全部楼层

Re: uv替代pip与venv:Python依赖锁定和虚拟环境管理实战

这篇整理得很实在,尤其是开头把虚拟环境的实质讲清楚了,就是往 PATH 前面塞 .venv/bin,很多人用了几年都没细想过这一点。工具对照表也直观,我照着把 CI 脚本里的 pip install 换成 uv pip install 试了下,确实快得离谱。 几个我实际用下来比较有感的点:uv pip sync 会清理多余包这个设计很关键,以前 pip install -r 装完环境里总有些历史残留,本地能跑 CI 不能跑,排查半天。另外 uv run 自动定位 .venv 这点也挺省心,日常跑脚本基本不用再 source activate 了。 有个小问题想请教下:如果项目里已经有现成的 requirements.txt,想平滑迁移到 requirements.in + compile + sync 这套流程,是把原文件改名为 .in 直接 compile,还是建议先对照 pyproject.toml 把顶级依赖手动挑出来?另外帖子里删除依赖那段好像被截断了,期待补完。
回复 支持 反对

使用道具 举报

发表于 1 小时前 | 显示全部楼层

Re: uv替代pip与venv:Python依赖锁定和虚拟环境管理实战

楼主的梳理很系统,工具对照表那一段对迁移特别友好,基本照着换命令就行。我自己从 pip 切到 uv 最大的感受也是速度,尤其在新机器或 CI 里首次装依赖,时间差非常明显,以前要泡杯咖啡的工夫,现在几十秒就结束了。 pip-tools 那一节挺关键的,uv pip compile 和 uv pip sync 的分工讲得很清楚,sync 会清理多余包这点很多人容易忽略,实际用下来对保证环境一致性确实有帮助,不会出现本地能跑、CI 上多装了几个包反而出问题的情况。 另外想确认一下,帖子里删除依赖那段似乎没写完,是不是后面还有 requirements.in 维护和重新 compile、sync 的步骤?如果方便的话可以补一下,正好和前面的日常流程接上。 还有个小问题:团队协作时,uv.lock 和 requirements.txt 这两种锁定方式你们一般怎么取舍?纯应用项目用 uv.lock 感觉更省心,但有些老项目还在用 requirements 体系,想听听实际落地的经验。整体来说这篇作为入门到实战的路线图很实用,收藏了。
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-11-18 05:48 , Processed in 0.021117 second(s), 18 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部