uv 命令-配置国内源：Python 包管理加速方案

主要功能

• 极速依赖同步：读取 pyproject.toml 或 requirements.txt，通过并行下载与缓存机制，将依赖安装耗时从传统 pip 的 30-120 秒压缩至 2-10 秒。输出为可直接运行的虚拟环境。
• 虚拟环境自动管理：运行 uv run python main.py 时，自动创建或激活 .venv，无需手动执行 source .venv/bin/activate。省去两步操作，直接执行目标脚本。
• 国内源永久配置：通过 ~/.config/uv/uv.toml 文件写入 [[index]] 块，指定 url = "https://pypi.tuna.tsinghua.edu.cn/simple" 并设置 default = true。后续所有 uv sync 操作自动走该源，无需每次指定。
• 单次源切换：执行 uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple 或 uv pip install package_name --index-url ...，仅本次操作使用指定源，不影响全局配置。适合临时测试或非稳定源场景。
• 命令链简化：uv run python main.py 等价于 source .venv/bin/activate && python main.py，但省去激活步骤。直接执行，减少终端操作次数。

如何使用

• 首次配置：执行 mkdir -p ~/.config/uv，然后 cat > ~/.config/uv/uv.toml << EOF，粘贴 [[index]] 配置块，最后输入 EOF 保存。完成后 uv sync 自动走国内源。
• 日常运行：项目根目录下执行 uv run python main.py。uv 会自动检查 .venv 是否存在，不存在则创建，然后激活并运行脚本。
• 临时换源：若需使用其他源，在命令后加 --index-url 参数。例如 uv sync --index-url https://pypi.doubanio.com/simple。不写配置文件，不影响后续操作。
• 包安装：使用 uv pip install requests 安装单个包。若配置了国内源，直接走镜像；否则走默认 PyPI。

同类竞品对比

应用场景

• 持续集成流水线：在 CI 环境中，uv sync 耗时 2-10 秒，相比 pip 的 30-120 秒，能显著缩短构建时间。尤其适合高频提交的项目。
• 快速原型开发：开发者只需 uv run script.py 即可运行，无需手动管理虚拟环境。省去环境搭建步骤。
• 国内网络环境优化：通过配置 uv.toml 指向清华源，避免 PyPI 官方源的网络延迟。下载速度提升明显，尤其对于大型依赖包。
• 多项目切换：不同项目使用不同 Python 版本或依赖源时，uv 自动识别项目配置，无需手动切换环境。每个项目独立管理。

核心优势

• 速度：依赖安装比传统 pip 快 10 倍以上。核心机制是 Rust 编写的并行下载器，加上本地缓存，减少重复下载。
• 简化操作：uv run 将虚拟环境创建、激活、脚本执行合并为一条命令。降低新手使用门槛，也减少老手的重复劳动。

有一点需要注意：uv 目前仍处于快速迭代阶段，部分高级功能（如私有源认证）可能需要额外配置。实际使用时，建议先在小项目上测试兼容性。