功能特性
uv 为 Python 开发提供核心功能——从安装 Python 和编写简单脚本，到支持多 Python 版本和多平台的大型项目开发。
uv 的接口可分为多个独立或协同使用的功能模块。
Python 版本管理
安装和管理 Python 解释器本身。
uv python install: 安装 Python 版本uv python list: 查看可用 Python 版本uv python find: 查找已安装的 Python 版本uv python pin: 将当前项目固定使用特定 Python 版本uv python uninstall: 卸载 Python 版本
参考 Python 安装指南 开始使用。
脚本运行
执行独立的 Python 脚本，例如 example.py。
uv run: 运行脚本uv add --script: 为脚本添加依赖uv remove --script: 从脚本移除依赖
参考 脚本运行指南 开始使用。
项目管理
创建和开发带有 pyproject.toml 的 Python 项目。
uv init: 创建新 Python 项目uv add: 为项目添加依赖uv remove: 从项目移除依赖uv sync: 同步项目依赖到环境uv lock: 为项目依赖创建锁文件uv run: 在项目环境中运行命令uv tree: 查看项目依赖树uv build: 构建项目为分发包uv publish: 发布项目到包索引
参考 项目管理指南 开始使用。
工具
运行和安装发布到 Python 包索引的工具，例如 ruff 或 black。
uvx/uv tool run: 在临时环境中运行工具uv tool install: 为用户全局安装工具uv tool uninstall: 卸载工具uv tool list: 列出已安装的工具uv tool update-shell: 更新 shell 以包含工具可执行文件
参考工具指南开始使用。
pip 接口
手动管理环境和包 —— 适用于遗留工作流或高级命令无法提供足够控制的情况。
创建虚拟环境（替代 venv 和 virtualenv）：
uv venv：创建新的虚拟环境。
详情请参阅使用环境文档。
管理环境中的包（替代 pip 和 pipdeptree）：
uv pip install：将包安装到当前环境uv pip show：显示已安装包的详细信息uv pip freeze：列出已安装包及其版本uv pip check：检查当前环境的包兼容性uv pip list：列出已安装包uv pip uninstall：卸载包uv pip tree：查看环境的依赖树
详情请参阅管理包文档。
锁定环境中的包（替代 pip-tools）：
uv pip compile：将需求编译为锁定文件uv pip sync：根据锁定文件同步环境
详情请参阅锁定环境文档。
Important
这些命令并不完全实现其所基于工具的接口和行为。偏离常见工作流越远，越可能遇到差异。详情请参阅pip兼容性指南。
实用工具
管理和检查 uv 的状态，例如缓存、存储目录或执行自我更新：
uv cache clean: 清除缓存条目uv cache prune: 清除过期的缓存条目uv cache dir: 显示 uv 缓存目录路径uv tool dir: 显示 uv 工具目录路径uv python dir: 显示 uv 安装的 Python 版本路径uv self update: 将 uv 更新至最新版本