Python 高效开发：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

项目依赖管理

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

# 初始化项目（生成 pyproject.toml）
uv init my_project
cd my_project

# 添加依赖（自动写入 pyproject.toml）
uv add requests          # 生产依赖
uv add --dev pytest      # 开发依赖

# 同步依赖（移除未声明的包）
uv sync

运行代码

可直接运行脚本或模块，自动使用当前虚拟环境：

# 运行脚本
uv run script.py

# 运行临时代码
uv run -c "print('Hello, uv!')"

# 运行模块
uv run -m http.server 8000

进阶技巧

缓存管理

uv 拥有全局缓存机制，清理缓存可释放空间：

uv cache clean

指定 Python 版本

uv 能自动下载并管理指定版本的 Python，无需额外配置 pyenv：

# 安装 Python 3.11
uv python install 3.11

# 使用 3.11 运行脚本
uv run --python 3.11 script.py

加速现有项目

如果暂时不想切换命令，仍可用 uv 加速 pip 操作：

uv pip install requests

总结

1. 性能优势：uv 是高性能的 Python 包与环境管理工具，核心优势是速度快、功能集成度高。
2. 核心命令：掌握 uv pip install（安装包）、uv venv（环境）、uv add（依赖）、uv run（运行）即可覆盖大部分场景。
3. 最佳实践：推荐在新项目中优先使用 uv init + pyproject.toml 替代传统 requirements.txt，提升依赖管理的规范性与可维护性。