國內Python包鏡像地址如下:
- 清華:https://pypi.tuna.tsinghua.edu.cn/simple/
- 阿里云:https://mirrors.aliyun.com/pypi/simple/
- 中國科技大學:https://pypi.mirrors.ustc.edu.cn/simple/
- 華為云:https://repo.huaweicloud.com/repository/pypi/simple/
- 騰訊云:https://mirrors.cloud.tencent.com/pypi/simple/
比如想把 pip 安裝時的默認源設為清華源,從而提升國內的下載速度,可按下面的方法對 pip 進行配置:
一、單次安裝時指定清華源
在使用 pip 執行安裝命令時,借助 -i
參數就能臨時指定清華源,示例如下:
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple
二、永久修改默認源(推薦做法)
1. 配置文件法(推薦)
創建或編輯 pip 的配置文件,具體操作如下:
-
Windows 系統:
先在C:\Users\你的用戶名\pip\
路徑下創建pip.ini
文件,若該路徑不存在則先創建相應文件夾,然后在pip.ini
中寫入以下內容:
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple[install] trusted-host = pypi.tuna.tsinghua.edu.cn
-
macOS/Linux 系統:
編輯~/.pip/pip.conf
文件(若文件不存在則創建),寫入如下內容:[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple[install] trusted-host = pypi.tuna.tsinghua.edu.cn
2. 命令行快速配置
通過命令直接生成配置文件,以 macOS/Linux 系統為例:
mkdir -p ~/.pip
cat > ~/.pip/pip.conf << EOF
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn
EOF
三、驗證配置是否成功
執行以下命令安裝某個包,觀察輸出信息:
pip install requests
若輸出中包含類似 Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple
的內容,就表明配置已成功生效。
四、其他常見國內鏡像源
除了清華源,國內還有一些其他常用的鏡像源,你也可以根據自身需求進行切換:
- 阿里云:
https://mirrors.aliyun.com/pypi/simple/
- 中國科技大學:
https://pypi.mirrors.ustc.edu.cn/simple/
- 豆瓣:
https://pypi.doubanio.com/simple/
若要切換為其他鏡像源,只需在配置文件里修改 index-url
字段即可。
五、注意事項
- 虛擬環境:上述配置是全局生效的。如果使用了虛擬環境,且該虛擬環境有獨立的 pip 配置,就需要單獨進行設置。
- 臨時切換:當清華源出現問題時,可通過
-i
參數臨時使用其他鏡像源。 - HTTPS 驗證:添加
trusted-host
是為了信任清華源的 HTTPS 證書,防止出現安全提示。