比 pip 快 100 倍、能替代 8 款传统工具，从零到实战一篇就够！

还在 pip、poetry、pyenv、pipx 之间来回切换？
Astral 团队用 Rust 写出的 uv 一次性帮你搞定：
o 10-100× 安装速度
o 单文件即可管理依赖、虚拟环境、Python 版本
o 完全兼容旧命令，无痛迁移

今天带你 15 分钟上手 uv 的全部核心功能！

一、极速安装：一行命令跨平台

装完验证：uv --version

二、5 大高频场景速查表

三、项目级实战：从 0 到上线

1. 初始化

uv init myproj && cd myproj
# 自动生成 pyproject.toml + .venv

2. 增删依赖

uv add "fastapi>=0.110" uvicorn[standard]   # 写入 pyproject.toml 并安装
uv remove requests                          # 一键卸载
uv lock                                     # 生成 uv.lock 保证可复现

3. 运行 & 部署

uv run python main.py        # 自动激活虚拟环境
uv sync                      # CI 中极速恢复依赖[^16^]

四、可视化依赖树

uv tree --depth 2            # 只看两层，防止刷屏
uv tree --outdated           # 谁需要升级一目了然

五、单文件脚本黑科技 把依赖直接写进脚本头部，无需手动建环境：

# /// script
# requires-python = ">=3.11"
# dependencies = ["rich", "requests"]
# ///
import rich, requests
rich.print(requests.get("https://httpbin.org/json").json())

执行：uv run script.py
uv 会当场创建临时虚拟环境并缓存，第二次 1 秒启动！

六、工作区（Monorepo）示例 大型仓库也能像 Rust Cargo 一样管理：

albatross                # 根目录
├── pyproject.toml       # [tool.uv.workspace] 定义成员
├── packages
│   ├── bird-feeder     # 子包1
│   └── seeds           # 子包2
└── uv.lock             # 全局统一锁文件[^16^]

在根目录执行一次 uv sync，所有子包共用虚拟环境，告别版本地狱。

七、PyTorch 场景小贴士 国内源 + 自动选 CPU/CUDA：

UV_TORCH_BACKEND=auto \
uv add torch torchvision \
   --index pytorch-cu124=https://mirror.sjtu.edu.cn/pytorch-wheels/cu124

uv 会根据当前系统自动挑选合适版本。

八、一张图总结（文字版）

+------------+      +------------+
|   pip      |      |   pyenv    |  8 in 1
+------------+      +------------+
       \                 /              ===>  uv
        +---------------+
        | virtualenv    |
        +---------------+

总结 & 下一步 今天学到的：

1. 安装与全局加速
2. 项目生命周期（init → add → lock → sync）
3. 单文件脚本、工作区、PyTorch 加速技巧

下一步：
o 把旧项目 requirements.txt 一键迁移：uv pip compile -o requirements.txt
o 关注官方文档
https://docs.astral.sh/uv/，第一时间体验 --torch-backend=auto 等预览特性

收藏本文，随时速查 uv 命令，你的 Python 开发将再也离不开它！