uv + Python 环境工作流标题如果你在寻找“比 venv 更好的东西”,那你很可能指的是 Astral 的 uv:一个基于 Rust 的 Python 包和项目管理器,专注于速度和一体化工作流(安装 Python、创建 venv、管理依赖、锁定版本、运行脚本/工具)。[1]
为什么人们从 venv 转向 uv
- venv 只提供隔离。在实践中,你仍然需要为安装、锁文件、工具和多个 Python 版本而周旋于 pip、pip-tools、pipx、pyenv 等之间。
- uv 将这些常见工作流打包进单个 CLI,并且被设计得极快(最初定位为 pip 和 pip-tools 的直接替代品,现在已扩展到项目管理)。[2][3]
它非常适合以下人群:
- 你想要更顺畅的“类似 pnpm/cargo”的项目体验
- 你经常创建项目,并且在意可复现的安装(锁文件)
- 你希望比“venv + pip + pip-tools + pipx + pyenv …”涉及更少的组件
安装 uv
从官方安装指南中选择一种方法:[4]
- macOS(Homebrew)
- macOS/Linux(独立安装程序)
- curl -LsSf https://astral.sh/uv/install.sh | sh
- Windows(PowerShell)
- powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
验证:
从零创建项目(推荐:项目模式)
此工作流默认会在本地创建一个 .venv 并管理 pyproject.toml 以及一个锁文件。[3]
- 初始化
- 添加依赖(uv 会创建 venv 并安装)
- uv add requests
- uv add ruff --dev
- 生成/更新锁文件
- 从锁文件同步环境(在 CI 中很常见)
- 在项目环境中运行命令
- uv run python -c "import requests; print(requests.__version__)"
- uv run ruff check .
注意:
- 大多数 IDE(VS Code / PyCharm / Cursor)可以检测 .venv 自动。
- 将 .venv/ 添加到 .gitignore。
渐进式迁移路径:先替换“pip + venv”
你可以保留现有结构,并先从使用 uv 的 pip 接口开始:
- 创建虚拟环境: uv venv
- 安装依赖: uv pip install -r requirements.txt
这是一种低风险采用 uv 的方式,无需改变仓库的组织方式。[1]
脚本模式:单个 .py 文件的依赖
uv 可以通过嵌入依赖元数据,为单文件脚本管理隔离环境,然后用 uv run。[1]
- echo 'import requests; print(requests.get("https://astral.sh").status_code)' > example.py
- uv add --script example.py requests
- uv run example.py
这非常适合快速自动化脚本、实验和一次性数据任务。
工具:uvx 作为“类似 pipx”的体验
如果你想运行 CLI 工具而不将其添加到项目依赖中:
- 临时运行: uvx ruff --version (uvx 是……的别名 uv tool run)[5]
- 安装到你的 PATH: uv tool install ruff (仍然使用隔离环境)[1]
提示:如果工具需要导入你的项目包(例如, pytest, mypy),优先使用 uv run pytest 而不是 uvx pytest。[5]
uv 与 Poetry:如何选择
如果你的主要目标是“通过成熟的打包工作流将库发布到 PyPI”,Poetry 仍然是一个强有力的选择,拥有出色的文档、锁文件和打包功能。[6]
当你想要以下内容时,uv 尤其有吸引力:
- 安装/依赖解析速度
- 在一个 CLI 下统一日常工作流
- 对项目和脚本提供一流支持
常见的实际模式:
- 应用/服务:uv
- 用于分发的库:Poetry(或其他构建后端)仍然合理——不过 uv 也在扩展构建/发布能力。[3]
可复制粘贴的“标准工作流”
- 安装 uv
- uv init project && cd project
- uv add <deps> / uv add --dev <dev-deps>
- uv lock (将其提交)
- 本地: uv run ...
- CI: uv sync (完全可复现的安装)
注意事项与最佳实践
- 避免依赖存在多个“事实来源”。如果由 uv 管理项目,请将 pyproject.toml + lockfile 视为权威来源。
- 对于 Docker:复制 pyproject.toml + lockfile,然后运行 uv sync 在镜像构建中。
- 如果你的团队目前使用 requirements.txt ,请从 uv pip install -r requirements.txt 以实现平滑过渡。
参考资料(官方优先):
返回