摘要：uv 是一个基于 Rust 编写的现代化 Python 包管理工具，旨在替代 pip、venv、pip-tools 等多个工具，提供极速依赖解析、虚拟环境自动化、锁文件管理等一站式功能。
uv 是一个基于 Rust 编写的现代化 Python 包管理工具，旨在替代 pip、venv、pip-tools 等多个工具，提供极速依赖解析、虚拟环境自动化、锁文件管理等一站式功能。
安装方式 1 ： 使用 pip 安装（适用于测试）
pip install uv注意：此方式不包含 Rust 加速，性能较低，适合测试而非生产环境。
安装方式 2 ：推荐方式（官方脚本）
# Linux 或 macOScurl -Ls https://astral.sh/uv/install.sh | bash# Windows 用户建议使用 Powershell 安装（或手动下载可执行文件）irm https://astral.sh/uv/install.ps1 | iex提示：
在 Windows 中安装完成后，请将 uv 可执行文件路径（如 C:\Users\ \.local\bin）加入 。
# CMDset Path=%USERPROFILE%\.local\bin;%PATH%# Powershell$env:Path = "%USERPROFILE%\.local\bin;$env:Path"安装方式 3：使用 Homebrew（macOS）
brew install astral-sh/uv/uv安装完成后，可直接输入命令验证：
uv --help常见应用场景：
（1）快速创建 Python 虚拟环境并安装依赖。
（2）构建现代工程项目并精确锁定依赖。
（3）在 CI/CD 场景中重现相同的开发环境。
（4）使用 uv run 无需激活环境即可运行脚本。
（5）安装开发依赖（dev-dependencies）。
（6）管理项目中使用的工具链（如 ruff、black 等）。
（7）构建和发布 Python 包。
◆◆ ◆
核心概念
1、声明式依赖管理
使用 pyproject.toml 声明依赖。
2、锁文件机制
生成 uv.lock，完整记录依赖版本及子依赖。
3、自动虚拟环境
无需手动建 .venv，uv 自动处理。
4、隔离执行环境
运行脚本时自动启用项目虚拟环境。
5、高速依赖解析
基于 Rust 实现，比 pip 快数倍。
6、工具安装隔离
使用 uv tool 安装命令行工具而不污染全局。
◆◆ ◆
基本用法
1、初始化项目
uv init生成 pyproject.toml，用于声明依赖。
2、添加依赖（自动锁定）
uv add requests自动写入 pyproject.toml 与 uv.lock。
上述命令以添加 Request 第三方库为例。
3、同步安装依赖
uv sync根据锁文件同步所有依赖，默认自动使用 .venv 或 .uv 目录。
4、安装开发依赖
uv add --dev pytest5、移除依赖
uv remove requests6、执行脚本（无需手动激活环境）
uv run python example.py7、全局安装依赖（不推荐）
uv pip install requests --system◆◆ ◆
uv 命令解释
项目与依赖管理相关
uv run
在项目环境中运行命令或脚本。
uv init
初始化 pyproject.toml，创建项目配置。
uv add
向项目中添加依赖包并更新 lock 文件。
uv add requestsuv remove
从项目中移除指定依赖包。
uv version
查看或修改项目版本号。
uv sync
安装锁定依赖到本地虚拟环境。
uv lock
仅更新 uv.lock，不安装依赖。
uv export
导出 uv.lock 为其他格式，兼容 pip。
uv export --format=requirements.txtuv tree
查看依赖树结构（含子依赖）。
Python 与工具链管理
uv tool
安装并运行 Python 命令行工具，工具即装即用，无需创建虚拟环境，也不会污染全局环境。
uv tool install ruff # 安装 ruff 工具uv tool run ruff check . # 执行 ruff 检查当前目录uv python
安装指定版本 Python（需配置 Python 镜像）。
uv python install 3.13uv pip
提供兼容 pip 命令的接口，用于包管理。
uv pip install numpy #使用 pip 风格命令安装包uv pip freeze # 冻结当前环境依赖uv venv
创建新的虚拟环境。
uv venv myvenv构建与发布相关
uv build
构建项目为分发包（wheel、sdist）。
uv publish
发布包到 PyPI。
其他工具
uv cache
管理 uv 的缓存。
uv cache clean # 查看缓存内容uv cache clean # 清理缓存uv self
管理 uv 自身（如升级 uv）。
uv self updateuv help
显示帮助文档。
uv help add◆◆ ◆
补充说明
1、无需激活虚拟环境
所有命令默认识别项目路径并自动进入虚拟环境，不再需要 source venv/bin/activate 或 .venv\Scripts\activate。
2、锁文件作用
pyproject.toml 表示“我想要哪些依赖”。
uv.lock 表示“我实际使用的完整依赖”。
适用于部署与 CI 场景。
3、uv 与 pip 的区别
（1）uv 不依赖 pip，而是自带依赖解析与安装逻辑。
（2）兼容 pip 命令，用法平滑迁移。
（3）安装速度远胜 pip。
4、在 GitHub Actions 中使用 uv
- name: Install uvrun: curl -Ls https://astral.sh/uv/install.sh | bash- name: Install dependenciesrun: uv sync5、参考链接
官方网站：https://astral.sh/blog/uv/
GitHub 项目：https://github.com/astral-sh/uv
“点赞有美意，赞赏是鼓励”
来源：小象科技观
