Python 工具 uv 的安装、配置与最佳实践

2. 虚拟环境管理

uv 内置虚拟环境功能，比 venv 更简洁：

# 创建虚拟环境（默认在 .venv 目录）
uv venv
# 激活虚拟环境
# macOS/Linux
source .venv/bin/activate
# Windows (Cmd)
.venv\Scripts\activate.bat
# Windows (PowerShell)
.venv\Scripts\Activate.ps1
# 删除虚拟环境
rm -rf .venv # macOS/Linux
rmdir /s .venv # Windows

3. 项目依赖管理（兼容 pyproject.toml）

uv 支持现代 Python 项目的 pyproject.toml 配置，替代 requirements.txt：

# 初始化项目（生成 pyproject.toml）
uv init my_project
cd my_project
# 添加依赖（自动写入 pyproject.toml）
uv add requests # 生产依赖
uv add --dev pytest # 开发依赖
# 安装项目所有依赖（从 pyproject.toml）
uv install
# 同步依赖（移除未在 pyproject.toml 中声明的包）
uv sync

4. 运行 Python 代码/脚本

uv 可直接运行代码，自动使用当前虚拟环境：

# 运行脚本
uv run script.py
# 运行临时代码
uv run -c "print('Hello, uv!')"
# 运行模块
uv run -m http.server 8000

四、进阶用法

缓存管理：uv 有全局缓存，清理缓存命令：

uv cache clean # 清理所有缓存

指定 Python 版本：uv 可自动下载指定版本的 Python（需提前安装 pyenv 或 uv 内置的 Python 解析器）：

uv python install 3.11 # 安装 Python 3.11
uv run --python 3.11 script.py # 使用 3.11 运行脚本

加速 pip 兼容：如果项目暂时不想切换到 uv 命令，可通过 uv 加速 pip：

uv pip install requests # 等同于 pip install，但更快

总结

1. uv 是高性能的 Python 包/环境管理工具，安装简单，兼容 pip/venv 生态，核心优势是速度快、功能集成度高。
2. 核心用法：uv pip install（安装包）、uv venv（虚拟环境）、uv add（管理项目依赖）、uv run（运行代码）。
3. 推荐在新项目中使用 uv init + pyproject.toml 替代传统的 requirements.txt，提升依赖管理规范性。