配置后,所有 pip install 命令默认使用指定镜像源,无需每次加 -i 参数。核心是创建 / 修改 pip 的配置文件(pip.conf 或 pip.ini)。
步骤 1:找到配置文件路径(按操作系统区分)
操作系统 配置文件路径(全局) 说明
Windows %APPDATA%\pip\pip.ini 若没有 pip 文件夹,手动创建
Mac/Linux /.config/pip/pip.conf 或 /.pip/pip.conf 隐藏文件,用 ls -a 可查看
✅ 快速打开配置文件路径:
Windows:按 Win+R,输入 %APPDATA%\pip,回车后在文件夹中新建 pip.ini 文件;
Mac/Linux:打开终端,执行 mkdir -p /.pip(创建文件夹),再执行 touch /.pip/pip.conf(创建文件)。
步骤 2:编写配置文件内容
用记事本(Windows)或 vim/ 文本编辑器(Mac/Linux)打开配置文件,写入以下内容(以阿里云为例,替换为其他源只需改地址):
[global]
index-url = https://mirrors.aliyun.com/pypi/simple/ # 核心:指定默认镜像源
trusted-host = mirrors.aliyun.com # 信任该镜像源(避免 HTTPS 报错)
timeout = 120 # 超时时间(2分钟,解决慢网超时)
[install]
use-mirrors = true
mirrors = https://mirrors.aliyun.com/pypi/simple/
打开终端(或命令提示符),执行以下命令查看当前 pip 配置:
pip config list