Python設置pip鏡像源的幾種方法

更新時間：2025年12月02日 09:35:30 作者：冉成未來

本文介紹了在Python中使用pip設置鏡像源的方法,包括臨時使用、永久配置、使用命令配置、查看配置、恢復默認源和使用多個鏡像源等,推薦使用清華鏡像源或阿里云鏡像源,并提供了注意事項,如信任主機、超時設置和SSL驗證,需要的朋友可以參考下

1. 臨時使用鏡像源

在 pip 安裝命令中直接指定鏡像源：

# 使用清華鏡像源
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ package-name

# 使用阿里云鏡像源
pip install -i https://mirrors.aliyun.com/pypi/simple/ package-name

# 使用豆瓣鏡像源
pip install -i https://pypi.douban.com/simple/ package-name

# 使用中科大鏡像源
pip install -i https://pypi.mirrors.ustc.edu.cn/simple/ package-name

2. 永久配置鏡像源

Windows 系統

在用戶目錄下創(chuàng)建 pip 文件夾：

路徑：C:\Users\用戶名\pip\

創(chuàng)建 pip.ini 文件，添加以下內容：

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

Linux/macOS 系統

創(chuàng)建或修改配置文件：

# 創(chuàng)建目錄
mkdir -p ~/.pip

# 創(chuàng)建或修改配置文件
vim ~/.pip/pip.conf

添加以下內容：

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

3. 使用命令配置

# 設置清華源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

# 設置阿里云源
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
pip config set global.trusted-host mirrors.aliyun.com

4. 查看當前配置

# 查看所有配置
pip config list

# 查看指定配置項
pip config get global.index-url

5. 常用國內鏡像源

# 清華鏡像源
https://pypi.tuna.tsinghua.edu.cn/simple/

# 阿里云鏡像源
https://mirrors.aliyun.com/pypi/simple/

# 豆瓣鏡像源
https://pypi.douban.com/simple/

# 中科大鏡像源
https://pypi.mirrors.ustc.edu.cn/simple/

# 華為云鏡像源
https://repo.huaweicloud.com/repository/pypi/simple/

6. 恢復默認源

如果需要恢復官方源：

# 刪除配置文件
# Windows: 刪除 C:\Users\用戶名\pip\pip.ini
# Linux/macOS: 刪除 ~/.pip/pip.conf

# 或者使用命令重置
pip config unset global.index-url

7. 使用多個鏡像源

如果需要配置多個鏡像源作為備份：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
extra-index-url = 
    https://mirrors.aliyun.com/pypi/simple/
    https://pypi.douban.com/simple/
trusted-host =
    pypi.tuna.tsinghua.edu.cn
    mirrors.aliyun.com
    pypi.douban.com