在windows11上如何配置pip使用自定义镜像源

在进行AI模型训练和部署时，我们往往需要安装大量的Python包。然而，默认的PyPI（Python Package Index）官方源在大陆访问速度较慢，甚至可能因网络波动导致安装失败。本文将详细指导您如何在Windows 11系统上，通过配置pip.ini文件，永久使用国内高速镜像源（如清华TUNA）加速包的安装。

1. 理解pip配置文件的位置

与Linux/macOS使用~/.config/pip/pip.conf不同，Windows系统上的pip配置文件位于用户AppData目录中。要实现系统级的永久配置，我们需要找到并创建以下路径：

1
%APPDATA%\pip\pip.ini

通常，这对应于 C:\Users\YourUsername\AppData\Roaming\pip\pip.ini。

2. 详细配置步骤（使用PowerShell）

为了操作方便和符合Windows 11的现代风格，我们使用PowerShell来执行创建目录和文件的操作。

步骤 2.1：创建配置文件夹

首先，检查并创建存放 pip.ini 文件的目录。如果目录已存在，此命令不会报错。

1
2
3
4
5
6
7
8
9
10
# 使用环境变量找到 Roaming 目录下的 pip 文件夹

$pip_dir = "$env:APPDATA\pip"



# 创建目录

if (-not (Test-Path $pip_dir)) {

    Write-Host "创建目录: $pip_dir"

    mkdir $pip_dir

} else {

    Write-Host "目录 $pip_dir 已存在."

}

步骤 2.2：创建并写入 pip.ini 文件

我们将使用清华大学（TUNA）的镜像源作为示例。它稳定且速度快。

配置内容如下：

1
2
3
4
5
6
7
8
9
[global]

# 核心配置：指定新的索引源URL

index-url = https://pypi.tuna.tsinghua.edu.cn/simple



# 增加信任主机，避免因非HTTPS官方源导致的SSL证书错误

trusted-host = pypi.tuna.tsinghua.edu.cn



# 可选：设置超时时间，防止网络不稳定导致的连接中断 (单位：秒)

timeout = 6000

在PowerShell中写入文件：

1
2
3
4
5
6
7
8
9
10
11
12
$config_content = @"

[global]

index-url = https://pypi.tuna.tsinghua.edu.cn/simple

trusted-host = pypi.tuna.tsinghua.edu.cn

timeout = 6000

"@



# 写入配置文件

$config_path = "$env:APPDATA\pip\pip.ini"

$config_content | Out-File -FilePath $config_path -Encoding UTF8



Write-Host "pip.ini 配置已成功写入: $config_path"

注意： 如果您希望使用其他镜像源（例如阿里云、豆瓣），只需修改 index-url 的值即可。

步骤 2.3：验证配置是否生效

配置完成后，我们使用 pip config 命令来查看当前生效的配置项。

1
pip config list

预期输出示例 (可能会因pip版本略有不同):

1
2
3
global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'

global.timeout='6000'

global.trusted-host='pypi.tuna.tsinghua.edu.cn'

接下来，尝试安装一个轻量级库进行实际测试：

1
pip install rich

如果安装速度明显加快，并且在输出中没有关于PyPI官方地址的提示，则说明镜像源配置成功。

3. 临时使用镜像源（可选）

如果您不想做永久修改，而只是在特定安装时使用镜像源，可以使用命令行参数：

1
pip install <package_name> -i https://pypi.tuna.tsinghua.edu.cn/simple

总结

通过配置 Windows 11 上的 pip.ini 文件，我们为所有 Python 环境（包括虚拟环境）提供了一个高速且稳定的包安装通道，这对于需要频繁安装和更新依赖的AI基础设施工程师和数据科学家来说，是提高工作效率的关键一步。