3 概念 on 编程那些事儿

3.5 包索引

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/concepts/indexes/

3.5 包索引

默认情况下，uv 使用 Python 包索引（PyPI）进行依赖解析和包安装。不过，可以通过 [[tool.uv.index]] 配置选项（以及对应的命令行选项 --index）把 uv 配置为使用其他包索引，包括私有索引。

3.7 解析

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/concepts/resolution/

3.7 解析

解析是指把一组要求转换为满足这些要求的一组包版本的过程。解析需要递归搜索包的兼容版本，确保所请求的要求得到满足，并且被请求包的要求之间相互兼容。

3.8 uv 构建后端

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/concepts/build-backend/

3.8 uv 构建后端

构建后端把源码树（即一个目录）转换为源码分发或 wheel。

uv 支持所有构建后端（如 PEP 517 所规定），同时也提供了一个原生构建后端（uv_build），它与 uv 紧密集成以改善性能和用户体验。

3.11 工具

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/concepts/tools/

3.11 工具

工具是提供命令行接口的 Python 包。

注意

关于使用工具接口的入门介绍，请参阅工具指南 —— 本文档讨论工具管理的细节。

`uv tool` 接口

uv 包含专门用于与工具交互的接口。工具可以在不安装的情况下用 uv tool run 调用，此时它们的依赖会被安装到与当前项目隔离的临时虚拟环境中。

3.12 Python 版本

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/concepts/python-versions/

3.12 Python 版本

一个 Python 版本由 Python 解释器（即 python 可执行文件）、标准库以及其他支持文件组成。

受管与系统 Python 安装

由于系统上通常已有 Python 安装，uv 支持发现 Python 版本。不过 uv 也支持自行安装 Python 版本。为区分这两类 Python 安装，uv 把它安装的 Python 版本称为受管 Python 安装，把所有其他 Python 安装称为系统 Python 安装。

3.13 配置文件

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/concepts/configuration-files/

3.13 配置文件

uv 支持项目级和用户级的持久配置文件。

具体来说，uv 会在当前目录或最近的父目录中搜索 pyproject.toml 或 uv.toml 文件。

注意

对于在用户级别运行的 tool 命令，本地配置文件会被忽略。此时 uv 只会读取用户级配置（例如 ~/.config/uv/uv.toml）和系统级配置（例如 /etc/uv/uv.toml）。

3.16 缓存

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/concepts/cache/

3.16 缓存

依赖缓存

uv 使用积极缓存，以避免重新下载（和重新构建）此前运行中已访问过的依赖。

uv 缓存语义的具体细节取决于依赖的性质：

对于仓库依赖（例如从 PyPI 下载的那些），uv 遵循 HTTP 缓存头。
对于直接 URL 依赖，uv 遵循 HTTP 缓存头，同时还会根据 URL 本身缓存。
对于 Git 依赖，uv 根据完全解析出的 Git 提交哈希缓存。因此 uv pip compile 在写出解析后的依赖集合时，会把 Git 依赖固定到特定提交哈希。
对于本地依赖，uv 根据源归档（即本地 .whl 或 .tar.gz 文件）的最后修改时间缓存。对于目录，uv 根据 pyproject.toml、setup.py 或 setup.cfg 文件的最后修改时间缓存。
对于扁平索引（即 --find-links 位置），uv 假定索引内容不可变，按名称缓存每个文件。因此，用新内容替换同名文件（例如把重新构建的 wheel 放入 --find-links 目录）在缓存刷新之前不会被识别。

如果你遇到缓存问题，uv 提供了一些应急手段：

3.17 预览特性

Fri, 25 Sep 2026 19:02:24 +0800

原文链接: https://docs.astral.sh/uv/concepts/preview/

3.17 预览特性

uv 包含需要显式启用的预览特性，以便收集社区反馈，并在面向所有人启用之前提高对“这些改动确有益处”的信心。

启用预览特性

要启用所有预览特性，请使用 --preview 标志：

3 概念 on 编程那些事儿

3.5 包索引

3.5 包索引

3.7 解析

3.7 解析

3.8 uv 构建后端

3.8 uv 构建后端

3.11 工具

3.11 工具

uv tool 接口

3.12 Python 版本

3.12 Python 版本

受管与系统 Python 安装

3.13 配置文件

3.13 配置文件

3.16 缓存

3.16 缓存

依赖缓存

3.17 预览特性

3.17 预览特性

启用预览特性

`uv tool` 接口