✅ 推荐方式：临时使用镜像（无需修改配置）

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名

✅ 永久配置镜像（修改配置文件）

1. 找到或创建配置文件

• Windows：%APPDATA%\pip\pip.ini
  • win7下是：Writing to C:\Users\xx\AppData\Roaming\pip\pip.ini
• macOS/Linux：~/.pip/pip.conf

2. 添加以下内容（以清华镜像为例）：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

trusted-host 是为了避免 HTTPS 证书警告。

✅ 使用环境变量（适合 CI/CD 或脚本）

export PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple

⚠️ 注意事项

• 镜像源可能同步延迟，新版本包可能晚于官方源。
• 某些私有包或依赖官方源的包可能安装失败，此时可临时切换回官方源：
  bash

   

• 复制

  pip install 包名 -i https://pypi.org/simple

   

✅ 一键配置命令（Linux/macOS）

mkdir -p ~/.pip
cat > ~/.pip/pip.conf <<EOF
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF

临时使用：

可以在使用pip的时候加参数-i https://pypi.tuna.tsinghua.edu.cn/simple

例如：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyspider，这样就会从清华这边的镜像去安装pyspider库。

永久修改，一劳永逸：

Linux下，修改 ~/.pip/pip.conf (没有就创建一个文件夹及文件。文件夹要加“.”，表示是隐藏文件夹)

内容如下：

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

[install]
trusted-host=mirrors.aliyun.com

windows下，直接在user目录中创建一个pip目录，如：C:\Users\xx\pip，新建文件pip.ini。内容同上。

1.在windows文件管理器中输入“ %APPDATA% ”，如下图所示：
2.则会定位到一个新的目录下(“C:\Users\Administrator\AppData\Roaming\pip\pip.ini”)，Administrator为自己的用户名，在该目录下新建pip文件夹，然后到匹配文件夹中新建一个 pip.ini 文件，如下图所示 ：
3.在新建的 pip.ini 文件中输入以下内容，然后保存。
注意:" index-url " 的内容是镜像源的路径，可以更换