python包管理工具-UV国内使用简单配置

前言

  本文专为国内开发者撰写，只需三步配置，即可让UV满速运行。一分钟配置，换来的是每次环境搭建节省的几十分钟。

一、UV是什么？

  UV，由 Rust 编写，出自打造了 Ruff 等明星工具的 Astral 团队。 它并非一个简单的“更快的 Pip”，而是一个雄心勃勃的、旨在统一和取 代 Pip、Pipenv、Poetry、Virtualenv 等多个工具的一站式解决方案。其核心优势就是两个字：“极速”。无论是依赖解析、下载安装还是创建虚拟环 境，UV 的速度都能带来数量级的提升，将以往数分钟甚至更久的等待缩短至秒级。

二、配置步骤

1.配置文件位置

Tip：UV支持项目级和用户级的持久化配置

• 项目级配置
    UV会从当前工作目录或最近的父目录中查找 pyproject.toml 或 uv.toml 文件

• 用户级配置

  • macOS 和 Linux 系统上的~/.config/uv/uv.toml
  • Windows 系统上的 %APPDATA%\uv\uv.toml

• 系统及配置

  • macOS 和 Linux 系统上的/etc/uv/uv.toml
  • Windows 系统上的 %SYSTEMDRIVE%\ProgramData\uv\uv.toml

Tip：uv.toml 文件优先于 pyproject.toml 文件，因此如果一个目录中同时存在 uv.toml 和 pyproject.toml 文件，将从 uv.toml 中读取配置，而 pyproject.toml 中的 [tool.uv] 部分将被忽略。

2.配置文件内容

本文主要介绍配置uv.toml文件来配置UV的国内环境，如需使用pyproject.toml文件配置，只需在配置头添加tool.uv前缀即可。例：[[index]] => [[tool.uv.index]]

uv.toml文件内容

python-install-mirror = "https://registry.npmmirror.com/-/binary/python-build-standalone/"

[[index]]
url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"
default = true

[pip]
index-url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"

以上共有三组配置：

1. 第一组：
   这是uv安装python解释器的镜像配置，默认地址为https://github.com/astral-sh/python-build-standalone/releases/download如果有GitHub代理，也可使用代理进行替换。
2. 第二组:（配置过pip的小伙伴肯定非常熟悉）
   这是uv解析依赖时所使用的索引，适用于uv add等命令。
3. 第三组：
   用于仅配置uv pip命令行接口。此部分中的设置仅适用于uv pip命名空间的 uv 命令。

牛马小提示：作者在Windows系统下将UV配置文件放在用户级配置下时发现，当用uv tool命令卸载所有工具时会删除 %APPDATA%\uv整个文件夹。因此建议Windows开发者将uv的配置文件放在系统级目录下

总结

  以上就是今天的内容，本文仅仅简单介绍了UV国内配置，而UV具有强大的python虚拟环境管理和包管理功能，总体上 uv 绝对是一个值得一试的 python 管理工具。