Python UV 源配置：从全局到临时及项目级

Windows UV 源配置, 从全局到临时及项目级: 针对 Windows 系统，我为你整理了最简洁、易操作的 uv 国内源配置方案，优先推荐永久全局配置（一劳永逸），附详细图文步骤：

方案 1：永久全局配置（推荐）

步骤 1：打开 uv 配置文件目录

1. 按下 Win + R 打开「运行」窗口，输入 %APPDATA%\uv，回车：

   1. 如果提示「找不到该文件夹」，手动新建：在 C:\Users\你的用户名\AppData\Roaming 下新建 uv 文件夹（AppData 默认隐藏，可直接粘贴路径访问）。

步骤 2：创建/编辑 uv.toml 配置文件

1. 在 uv 文件夹内，右键 → 新建 → 文本文档，重命名为 uv.toml（注意后缀是 .toml，不是 .txt，需先显示文件扩展名：文件资源管理器 → 查看 → 勾选「文件扩展名」）。
2. 双击打开 uv.toml，粘贴以下内容（使用清华源，最稳定）：

# uv 国内源配置（Windows 全局生效）
[[index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true  # 设置为默认源

# 可选：保留官方源作为备用（无需可删除）
[[index]]
url = "https://pypi.org/simple"

3. 保存文件并关闭。

验证是否生效

1. 打开 cmd/PowerShell，执行：

uv pip install numpy

2. 输出中如果包含 Using index-url https://pypi.tuna.tsinghua.edu.cn/simple，说明配置成功。

方案 2：临时生效（仅当前终端）

如果不想改全局配置，每次安装前在 PowerShell 中执行：

# 设置临时源（清华源）
$env:UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"

# 然后安装包
uv pip install requests  # 示例：安装 requests

方案 3：项目级配置（仅当前项目）

在项目根目录新建 uv.toml 文件，粘贴以下内容即可（仅对该项目生效）：

[tool.uv]
index-url = "https://pypi.tuna.tsinghua.edu.cn/simple"

常见问题解决

1. 文件重命名失败：确保文件扩展名已显示，避免创建出 uv.toml.txt。
2. 安装仍慢：检查网络，或替换为阿里云源（把配置中的 url 换成 https://mirrors.aliyun.com/pypi/simple/）。
3. 权限错误：右键 uv.toml → 属性 → 取消「只读」，或用管理员身份打开编辑器。

总结

1. Windows 下 uv 最推荐全局配置：通过 %APPDATA%\uv\uv.toml 文件设置清华源，永久生效。
2. 临时使用可通过 PowerShell 环境变量 $env:UV_INDEX_URL 指定国内源。
3. 验证生效的核心是看安装时输出的 index-url 是否为国内源地址。