uv 是 Astral 开发的高速 Python 包与项目管理器。本资料是一份围绕 uv 0.13.1 的参考技能,内容按主题分类整理,供查阅命令、概念和配置说明。
用途与组织方式:资料目标版本为 uv 0.13.1(对应 GitHub tag 与 commit,发布于 2026-10-14),并声明不使用 main 分支。生成页面未提交到仓库,因此从官方文档的 Markdown 版本于 2026-10-16 获取。目录包含 SKILL.md、references(按类别分目录)、samples 示例和 scripts 脚本说明。
主要能力范围:
- getting-started:安装、首次启动、版本策略、0.13 破坏性变更、平台支持。
- projects:项目创建、依赖与依赖组、工作区、lock/sync、PEP 723 脚本、构建隔离、导出等。
- project-commands:uv、uv add、uv run、uv sync、uv lock、uv export、uv tree、uv audit、uv format、uv init、uv remove、uv version、uv workspace 等命令参考。
- tools:uvx / uv tool 安装、运行、列出、升级、卸载命令行工具。
- python:Python 安装、发现、pin、升级、卸载,含 free-threaded 版本与受管发行版。
- pip-interface:uv pip 与 uv venv 的 pip/pip-tools 兼容工作流,含 install、sync、compile、freeze、list、show、tree、check 等。
- build-publish:uv build、uv publish 与 uv_build 构建后端。
- resolution:解析策略、约束/覆盖/排除、平台标记、预发布、多版本解析等。
- indexes-auth:外部索引、认证、证书、uv auth 命令。
- configuration:uv.toml / [tool.uv] 设置、UV_* 环境变量、缓存、preview 功能、uv self。
- integrations:Docker、GitHub Actions、GitLab CI、pre-commit、PyTorch、Jupyter、AWS Lambda、Bazel 等。
使用方式:先从任务映射到类别,阅读该类别 README 找到目标页面,再读取对应 .md 文件;典型用法见 samples/README.md,命令脚本见 scripts/README.md。
适用场景:需要查询 uv 的命令选项、项目与依赖管理、Python 版本管理、pip 迁移兼容、构建发布、解析与索引配置,以及 CI/Docker 集成时使用。
限制:资料为参考文档集合,未提供收费、价格、平台兼容细节;具体行为以对应版本文档为准。