2.7 集成 on 编程那些事儿

2.7.1 在 Docker 中使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/docker/

2.7.1 在 Docker 中使用

快速开始

提示

在 Docker 中使用 uv 构建应用的最佳实践示例，请查看 uv-docker-example 项目。

uv 同时提供无发行版（distroless）Docker 镜像和基于常见基础镜像派生的镜像。前者适合在构建自己的镜像时复制 uv 二进制文件，后者适合在容器中使用 uv。无发行版镜像除 uv 二进制文件之外不包含任何内容；相对地，派生镜像则包含预装 uv 的操作系统。

2.7.2 与 Jupyter 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/jupyter/

2.7.2 与 Jupyter 配合使用

Jupyter notebook 是交互式计算、数据分析和可视化的常用工具。你可以用几种不同方式把 Jupyter 与 uv 配合使用，既可以与项目交互，也可以把它当作独立工具。

2.7.3 与 marimo 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/marimo/

2.7.3 与 marimo 配合使用

marimo 是一个开源 Python notebook，它把交互式计算与传统软件的可复现性和可复用性结合起来，让你可以用 Git 做版本管理、作为脚本运行，并作为应用分享。由于 marimo notebook 以纯 Python 脚本形式存储，它们能够与 uv 紧密集成。

2.7.4 在 GitHub Actions 中使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/github/

2.7.4 在 GitHub Actions 中使用

安装

在 GitHub Actions 中使用时，我们推荐官方 astral-sh/setup-uv action：它会安装 uv、把它加入 PATH、（可选地）持久化缓存等，并支持 uv 支持的所有平台。

2.7.5 在 GitLab CI/CD 中使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/gitlab/

2.7.5 在 GitLab CI/CD 中使用

使用 uv 镜像

Astral 提供了预装 uv 的 Docker 镜像。请选择适合你工作流的变体。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# .gitlab-ci.yml
variables:
 UV_VERSION: "0.12.19"
 PYTHON_VERSION: "3.12"
 BASE_LAYER: trixie-slim
 # GitLab CI 会为构建目录创建单独的挂载点，
 # 所以我们需要复制而不是使用硬链接。
 UV_LINK_MODE: copy

uv:
 image: ghcr.io/astral-sh/uv:$UV_VERSION-python$PYTHON_VERSION-$BASE_LAYER
 script:
 # 你的 `uv` 命令

注意

2.7.6 与 pre-commit 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/pre-commit/

2.7.6 与 pre-commit 配合使用

官方 pre-commit 钩子位于 astral-sh/uv-pre-commit。

要把 uv 与 pre-commit 配合使用，请把下面示例之一加入 .pre-commit-config.yaml 的 repos 列表。

要确保即使 pyproject.toml 被修改后 uv.lock 文件仍然是最新的：

1
2
3
4
5
6
7


# .pre-commit-config.yaml
repos:
 - repo: https://github.com/astral-sh/uv-pre-commit
 # uv 版本。
 rev: 0.12.19
 hooks:
 - id: uv-lock

要让 requirements.txt 文件与 uv.lock 文件保持同步：

2.7.7 与 PyTorch 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/pytorch/

2.7.7 与 PyTorch 配合使用

PyTorch 生态是深度学习研究和开发的热门选择。你可以用 uv 在不同 Python 版本和环境中管理 PyTorch 项目与 PyTorch 依赖，甚至可以控制加速器的选择（例如仅 CPU 还是 CUDA）。

2.7.8 与 FastAPI 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/fastapi/

2.7.8 与 FastAPI 配合使用

FastAPI 是一个现代、高性能的 Python Web 框架。你可以用 uv 管理 FastAPI 项目，包括安装依赖、管理环境、运行 FastAPI 应用等。

注意

本指南的源代码可以在 uv-fastapi-example 仓库中查看。

2.7.9 与 Bazel 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/bazel/

2.7.9 与 Bazel 配合使用

关于与 uv 配合的更广泛的 Bazel 工作流，请参阅 rules_py 的 uv 指南或 rules_python 的 uv 指南。

身份验证

Bazel 7 及更高版本通过 --credential_helper 选项支持凭据助手。要让 Bazel 拉取时使用 uv 存储的凭据，请先用托管 Bazel 需要拉取文件的服务的账号登录 uv：

2.7.10 与 Azure Artifacts 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/azure/

2.7.10 与 Azure Artifacts 配合使用

uv 可以从 Azure Artifacts 安装包，既可以使用个人访问令牌（PAT），也可以使用 keyring 包。

要使用 Azure Artifacts，请把索引添加到你的项目：

1
2
3
4


# pyproject.toml
[[tool.uv.index]]
name = "private-registry"
url = "https://pkgs.dev.azure.com/<ORGANIZATION>/<PROJECT>/_packaging/<FEED>/pypi/simple/"

使用 Azure 访问令牌进行身份验证

如果有可用的个人访问令牌（PAT）（例如 Azure 流水线中的 $(System.AccessToken)），可以通过 “Basic” HTTP 身份验证方案提供凭据。把 PAT 放在 URL 的密码字段中。用户名也必须提供，但可以是任意字符串。

2.7.11 与 Google Artifact Registry 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/google/

2.7.11 与 Google Artifact Registry 配合使用

uv 可以从 Google Artifact Registry 安装包，既可以使用访问令牌，也可以使用 keyring 包。

注意

本指南假设 gcloud CLI 已安装并完成身份验证。

要使用 Google Artifact Registry，请把索引添加到你的项目：

2.7.12 与 AWS CodeArtifact 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/aws/

2.7.12 与 AWS CodeArtifact 配合使用

uv 可以从 AWS CodeArtifact 安装包，既可以使用访问令牌，也可以使用 keyring 包。

注意

本指南假设 awscli 已安装并完成身份验证。

索引可以这样声明：

1
2
3
4


# pyproject.toml
[[tool.uv.index]]
name = "private-registry"
url = "https://<DOMAIN>-<ACCOUNT_ID>.d.codeartifact.<REGION>.amazonaws.com/pypi/<REPOSITORY>/simple/"

使用 AWS 访问令牌进行身份验证

凭据可以通过 “Basic” HTTP 身份验证方案提供。把访问令牌放在 URL 的密码字段中。用户名必须是 aws，否则身份验证会失败。

2.7.13 与 JFrog Artifactory 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/jfrog/

2.7.13 与 JFrog Artifactory 配合使用

uv 可以从 JFrog Artifactory 安装包，既可以使用用户名和密码，也可以使用 JWT 令牌。

要使用它，请把索引添加到你的项目：

1
2
3
4


# pyproject.toml
[[tool.uv.index]]
name = "private-registry"
url = "https://<organization>.jfrog.io/artifactory/api/pypi/<repository>/simple"

使用用户名和密码进行身份验证

1
2


$ export UV_INDEX_PRIVATE_REGISTRY_USERNAME="<username>"
$ export UV_INDEX_PRIVATE_REGISTRY_PASSWORD="<password>"

使用 JWT 令牌进行身份验证

1
2


$ export UV_INDEX_PRIVATE_REGISTRY_USERNAME=""
$ export UV_INDEX_PRIVATE_REGISTRY_PASSWORD="$JFROG_JWT_TOKEN"

注意

2.7.14 与 Renovate 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/renovate/

2.7.14 与 Renovate 配合使用

定期更新依赖被认为是最佳实践，可以避免暴露于漏洞、减少依赖之间的不兼容，并避免因版本过旧而导致的复杂升级。

uv 已得到 Renovate 的支持。

2.7.15 与 Dependabot 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/dependabot/

2.7.15 与 Dependabot 配合使用

定期更新依赖被认为是最佳实践，可以避免暴露于漏洞、减少依赖之间的不兼容，并避免因版本过旧而导致的复杂升级。

Dependabot 已宣布支持 uv，但还有一些用例尚不可用。更新情况请参阅 astral-sh/uv#2512。

2.7.16 与 AWS Lambda 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/aws-lambda/

2.7.16 与 AWS Lambda 配合使用

AWS Lambda 是一项无服务器计算服务，让你无需预置或管理服务器即可运行代码。

你可以把 uv 与 AWS Lambda 配合使用，管理 Python 依赖、构建部署包并部署 Lambda 函数。

2.7.17 与 Coiled 配合使用

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

原文链接: https://docs.astral.sh/uv/guides/integration/coiled/

2.7.17 与 Coiled 配合使用

Coiled 是一个无服务器、注重用户体验的云计算平台，让你可以轻松在云端硬件（AWS、GCP 和 Azure）上运行代码。

本指南展示如何使用 uv 管理依赖、使用 Coiled 部署到云端，从而在云上运行 Python 脚本。