跳到内容

功能

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 包索引的工具,例如 ruffblack

  • uvx / uv tool run:在临时环境中运行工具。
  • uv tool install:在用户层面安装工具。
  • uv tool uninstall:卸载工具。
  • uv tool list:列出已安装的工具。
  • uv tool update-shell:更新 shell 以包含工具可执行文件。

请参阅工具指南以开始使用。

pip 接口

手动管理环境和包——旨在用于遗留工作流,或高级命令无法提供足够控制的情况。

创建虚拟环境(替代 venvvirtualenv

  • uv venv:创建一个新的虚拟环境。

有关详细信息,请参阅使用环境文档。

管理环境中的包(替代 pippipdeptree

  • 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 功能的深入细节,或者在遇到任何问题时了解如何获取帮助