摘要:uv 是一个由 Astral 公司(Ruff、Black 的开发者)开发的 Python 工具,专注于快速管理虚拟环境和依赖。
以下是使用 uv 配置 Python 运行环境的详细步骤:
1. 安装 uv
uv 是一个由 Astral 公司(Ruff、Black 的开发者)开发的 Python 工具,专注于快速管理虚拟环境和依赖。
macOS/Linux
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
安装完成后,重启终端或运行:
bash
source ~/.bashrc # 或 source ~/.zshrc(根据你的 Shell 类型)
Windows (PowerShell)
powershell
irm https://astral.sh/uv/install.ps1 | iex
验证安装
bash
uv --version
2. 创建 Python 虚拟环境
uv 支持快速创建轻量级虚拟环境:
bash
uv venv venv # 创建名为 `venv` 的虚拟环境
这会生成一个 venv 目录,包含独立的 Python 解释器和依赖管理。
3. 激活虚拟环境
macOS/Linux
bash
source venv/bin/activate
Windows
powershell
.\venv\Scripts\activate
激活后,终端提示符会显示环境名称(如 (venv))。
4. 安装依赖
安装单个包
bash
uv pip install requests
从 requirements.txt 安装
bash
uv pip install -r requirements.txt
生成 requirements.txt
bash
uv pip freeze > requirements.txt
5. 替代 pip-compile(依赖锁定)
uv 可以生成精确的依赖锁文件(类似 pip-tools):
bash
uv pip compile pyproject.toml -o requirements.lock
6. 性能优化
依赖解析:比 pip 快 10-100 倍虚拟环境创建:比 venv 快 8 倍依赖安装:利用全局缓存加速重复安装7. 常用命令对比
传统命令uv 等效命令python -m venv venvuv venv venvpip install requestsuv pip install requestspip install -e .uv pip install -e .pip freezeuv pip freezepip-compile requirements.inuv pip compile requirements.in注意事项
兼容性:uv 支持 Python 3.8+,兼容大多数 pip 工作流缓存机制:依赖包会缓存在 ~/.cache/uv,节省磁盘空间生产环境:可通过 uv pip install --system 跳过虚拟环境直接安装预览功能:uv 仍在积极开发中,建议定期更新:bash
uv self upgrade
通过 uv 可以显著提升 Python 项目的依赖管理效率,尤其适合需要频繁创建环境或安装大量依赖的场景。
来源:老客数据一点号