uv 常用命令大全：极速 Python 包管理工具
uv 是一个用 Rust 编写的极其快速的 Python 包和项目管理器，旨在替代 pip、pip-tools、virtualenv、conda 等工具。它由 Astral 公司（创建 Ruff 的公司）开发，并且是 ruff 的'兄弟'工具。
🚀 安装 uv
# macOS 和 Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (Powershell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
📁 项目初始化
# 初始化一个新的 Python 项目
uv init my-project
cd my-project
# 在现有项目目录中初始化
uv init
🔧 虚拟环境管理
# 创建虚拟环境（默认 .venv）
uv venv
# 指定路径创建
uv venv /path/to/venv
# 使用特定 Python 版本
uv venv --python3.11
# 激活虚拟环境
# Linux/macOS
source .venv/bin/activate
# Windows
.venv\Scripts\activate
# 退出虚拟环境
deactivate
📦 依赖管理（核心功能）
安装包
# 安装单个包
uv add requests
# 安装多个包
uv add requests pandas numpy
# 安装指定版本
uv add "django>=4.2, <5.0"
# 安装开发依赖
uv add --dev pytest black
# 从 requirements.txt 安装
uv pip install -r requirements.txt
# 安装当前项目所有依赖
uv install
移除与更新
# 移除包
uv remove requests
# 更新单个包
uv update requests
# 更新所有包
uv update --all
依赖锁定
# 生成/更新锁文件
uv lock
# 根据锁文件精确安装
uv sync
🎯 运行项目
# 运行 Python 脚本
uv run myscript.py
# 运行模块
uv run -m pytest
# 运行自定义脚本（在 pyproject.toml 中定义）
uv run start
🔍 项目管理
# 查看已安装包
uv pip list
# 查看包详情
uv pip show requests
# 导出依赖到 requirements.txt
uv pip freeze > requirements.txt
🐍 Python 解释器管理
# 查看可安装的 Python 版本
uv python list
# 安装特定版本
uv python install 3.11
# 使用指定 Python 版本运行
uv run --python3.11 myscript.py
💡 典型工作流
1. 创建新项目
uv init my-project
cd my-project
2. 添加依赖
uv add requests pandas
uv add --dev pytest
3. 编写代码
在项目目录中创建 Python 文件
4. 运行测试
uv run -m pytest
5. 锁定依赖（部署准备）
uv lock
6. 在其他环境同步
git clone your-repo
uv sync
⚡ 性能优势
uv 相比传统工具具有显著的速度优势：
- 比 pip 快 10-100 倍
- 比 poetry 快 5-50 倍
- 并行解析和下载依赖
- 全局缓存机制
🎊 总结
uv 通过统一的命令行接口，将 Python 开发的多个环节整合在一起，提供了：
- ✅ 极速的包安装
- ✅ 虚拟环境管理
- ✅ 依赖解析和锁定
- ✅ 项目脚本运行
- ✅ Python 版本管理
无论你是初学者还是经验丰富的开发者，uv 都能显著提升你的 Python 开发体验！