如何为uv配置含凭证的额外软件包索引（类pip配置方式）

方法1：使用UV全局配置文件 #

UV支持全局配置文件，路径随操作系统不同而变化：

• Linux/macOS：~/.config/uv/config.toml
• Windows：%APPDATA%\uv\config.toml

在该文件中添加以下配置（将占位符替换为你的真实私密信息）：

# 方式1：直接声明带认证的额外索引
[registry.indexes]
"https://artifacts.path.to.commercial.index" = { index = true, auth = { username = "<user>", password = "<token>" } }

# 方式2：先定义额外索引列表，再单独配置认证
[registry]
extra_indexes = ["https://artifacts.path.to.commercial.index"]

[registry.indexes."https://artifacts.path.to.commercial.index"]
auth = { username = "<user>", password = "<token>" }

方法2：使用环境变量 #

若不想修改配置文件，可通过环境变量设置，全局生效的方式如下：

• Linux/macOS：将以下内容添加到~/.bashrc或~/.zshrc等shell配置文件中

  export UV_EXTRA_INDEX_URL="https://<user>:<token>@artifacts.path.to.commercial.index"
  

• Windows：在系统环境变量中添加UV_EXTRA_INDEX_URL，值为带认证信息的索引地址

注意事项 #

• 全局配置文件务必不要纳入版本控制，防止私密信息泄露
• 若令牌包含特殊字符，需先进行URL编码再填入配置
• 可执行uv config list命令验证配置是否生效

内容的提问来源于stack exchange，提问作者23479h3427983249