功能

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 更新到最新版本。

下一步

阅读 指南 以了解每个功能的介绍，查看 概念 页面以获取有关 uv 功能的深入详细信息，或者了解如何 获取帮助 如果您遇到任何问题。