简介

在 2025 年，uv 已成为 Python 生态中最受瞩目的“全能型”管理工具。它由 Astral 团队（Ruff 的开发者）使用 Rust 编写，旨在通过极致的性能和统一的体验，取代原有的多个零散工具

核心优势

极致的速度

安装速度比 pip 快 10 到 100 倍。其优秀的缓存设计使得在多次环境部署中几乎能实现秒级安装。

多合一工具箱

一个工具即可替代以下所有工具的功能：

1. pip / pip-tools / Poetry： 包安装与依赖锁定。
2. pyenv： Python 解释器版本管理（无需预装 Python，uv 可以直接下载安装）。
3. virtualenv： 虚拟环境创建与管理。
4. pipx： 独立运行 Python 工具（使用 uvx 命令）。
5. 现代项目管理： 使用 pyproject.toml 标准并支持生成 uv.lock 锁文件，确保跨平台的环境一致性。

安装方式

Window

powershell -Command "irm https://astral.sh/uv/install.ps1 | iex"

Linux

• 官方推荐：用 curl 或 wget 运行安装脚本：

  curl -lssf https://astral.sh/uv/install.sh | sh
  

  或

  wget -qo - https://astral.sh/uv/install.sh | sh
  

  详情可参考官方文档。

常用命令整理

功能分类	命令	功能描述	示例
项目初始化	uv init [project_name]	创建新项目，生成 pyproject.toml	uv init my_project
虚拟环境管理	uv venv	创建虚拟环境（默认 .venv）	uv venv --python 3.12
	source .venv/bin/activate	激活虚拟环境（Linux/macOS）
	.venv\Scripts\activate	激活虚拟环境（Windows）
	deactivate	退出虚拟环境
依赖管理	uv add [package]	安装单个包	uv add requests
	uv add --dev [package]	安装开发依赖	uv add --dev pytest
	uv remove [package]	移除包	uv remove requests
	uv sync	同步环境（根据 pyproject.toml）	uv sync
	uv tree	查看依赖树	uv tree --depth 2
运行脚本	uv run [script]	执行脚本（自动激活环境）	uv run main.py
工具管理	uv tool install [tool]	安装全局工具	uv tool install black
Python 版本管理	uv python install [version]	安装 Python 版本	uv python install 3.12
	uv python pin [version]	固定项目 Python 版本	uv python pin 3.12
缓存管理	uv cache clean	清理全局缓存	uv cache clean
其他实用命令	uv lock	生成锁文件	uv lock
	uv lock --upgrade-package	升级指定包	uv lock --upgrade-package loguru

国内镜像配置

配置文件路径

# 1. Linux/macOS 用户
# 路径：~/.config/uv/config.toml
# 创建方法：mkdir -p ~/.config/uv && touch ~/.config/uv/config.toml

# 2. Windows 用户
# 路径：C:\Users\你的用户名\AppData\Roaming\uv\config.toml
# 创建方法：在文件资源管理器中新建文件夹 uv，再创建文件 config.toml

config.toml内容

[[index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true