功能特性
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: 从脚本中移除依赖项
请参阅脚本运行指南以开始使用。
项目
创建和使用Python项目，例如使用pyproject.toml。
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: 使用锁定文件同步环境。
有关详细信息，请参阅锁定环境的文档。
重要
这些命令并未完全实现其所基于工具的接口和行为。偏离常见工作流程越远，越可能遇到差异。详情请参阅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更新至最新版本。