5 参考 on 编程那些事儿

5.1 CLI 参考

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

原文链接: https://docs.astral.sh/uv/reference/cli/

CLI Reference

uv

An extremely fast Python package manager.

Usage

uv [OPTIONS] <COMMAND>

Commands

uv auth Manage authentication

uv run Run a command or script

uv init Create a new project

uv add Add dependencies to the project

uv remove Remove dependencies from the project

uv version Read or update the project’s version

uv sync Update the project’s environment

uv lock Update the project’s lockfile

uv export Export the project’s lockfile to an alternate format

5.2 设置

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

原文链接: https://docs.astral.sh/uv/reference/settings/

Settings

Project metadata

`build-constraint-dependencies`

Constraints to apply when solving build dependencies.

Build constraints are used to restrict the versions of build dependencies that are selected when building a package during resolution or installation.

Including a package as a constraint will not trigger installation of the package during a build; instead, the package must be requested elsewhere in the project’s build dependency graph.

注意

In uv lock, uv sync, and uv run, uv will only read build-constraint-dependencies from the pyproject.toml at the workspace root, and will ignore any declarations in other workspace members or uv.toml files.

5.3 环境变量

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

原文链接: https://docs.astral.sh/uv/reference/environment/

Environment variables

uv defines and respects the following environment variables:

`UV_ASTRAL_MIRROR_URL`

自 0.11.14 起新增

Replaces the https://releases.astral.sh base URL for all Astral-mirrored metadata and artifact downloads.

When set, uv uses only the configured mirror URL and does not fall back to GitHub or raw GitHub. Path components in the URL are preserved: only trailing slashes are trimmed before appending the normal path suffix (e.g., /github/versions/main/v1/uv.ndjson).

5.4 存储

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

原文链接: https://docs.astral.sh/uv/reference/storage/

5.4 存储

存储目录

uv 使用以下高层目录进行存储。

对于每个位置，uv 会按给定顺序检查环境变量是否存在，并使用找到的第一个路径。

存储目录的路径与平台相关。uv 在 Linux 和 macOS 上遵循 XDG 约定，在 Windows 上遵循 Known Folder 方案。

5.5 安装器选项

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

原文链接: https://docs.astral.sh/uv/reference/installer/

5.5 安装器选项

更改安装路径

默认情况下，uv 安装在用户的可执行文件目录中。

要更改安装路径，请使用 UV_INSTALL_DIR：

1

$ curl -LsSf https://astral.sh/uv/install.sh | env UV_INSTALL_DIR="/custom/path" sh

1

PS> powershell -ExecutionPolicy ByPass -c {$env:UV_INSTALL_DIR = "C:\Custom\Path";irm https://astral.sh/uv/install.ps1 | iex}

注意

5.7 贡献

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

原文链接: https://docs.astral.sh/uv/reference/contributing/

5.7 贡献

寻找可以帮忙的地方

我们给认为是适合后续贡献的 issue 打上 help wanted 标签。它们对 Rust 和 uv 的经验要求各不相同。我们常常希望完成这些任务，但没有足够的资源自己来做。

5.10 基准测试

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

原文链接: https://docs.astral.sh/uv/reference/benchmarks/

5.10 基准测试

uv 的性能会持续与此前版本做基准对比，并定期与该领域的其他工具（如 pip 和 Poetry）比较。

最新的基准测试以及基准测试流程的细节可以在 GitHub 仓库中找到。