uv

高性能 Python 包与项目管理工具

补充说明

uv 用 Rust 实现，覆盖虚拟环境、依赖安装、项目锁定和工具运行。它兼容 pip 的部分命令，但项目模式更推荐 uv sync + uv.lock。

常用示例

uv venv
uv venv --python 3.12
uv pip install requests
uv pip compile requirements.in -o requirements.txt
uv init myapp
uv add requests
uv add --dev pytest
uv sync
uv lock
uv run python app.py
uv run pytest -q
uv tool install ruff
uvx ruff check .
uv python install 3.12

易错点与排错

• uv pip 是 pip 兼容层，不读写 pyproject.toml；项目依赖用 uv add。
• uv sync 以 pyproject.toml 和 uv.lock 为准，可能移除未声明的包。
• 没有虚拟环境时 uv pip install 需要显式 --system；不要误装到系统 Python。
• uvx 是临时环境，退出后不留包；需要长期使用就 uv tool install。
• Python 版本由 .python-version 或 --python 决定；换版本后要重新同步依赖。
• lockfile 要提交；CI 用 uv sync --frozen 保证可复现。
• 索引和认证配置与 pip 不完全相同；私有源要在 uv.toml 或环境变量中配置。
• 速度优势来自缓存和并行；首次冷启动仍会慢，不要把网络问题误判为工具问题。

相关命令

• python — 解释器
• pip — 传统包安装
• poetry — 另一种项目管理工具