快捷導(dǎo)航

Python設(shè)置pip鏡像源的幾種方法

更新時(shí)間：2025年12月02日 09:35:30 作者：冉成未來(lái)

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

1. 臨時(shí)使用鏡像源

在 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 系統(tǒng)

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

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

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

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

Linux/macOS 系統(tǒng)

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

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

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

添加以下內(nèi)容：

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

3. 使用命令配置

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

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

4. 查看當(dāng)前配置

# 查看所有配置
pip config list

# 查看指定配置項(xiàng)
pip config get global.index-url

5. 常用國(guó)內(nèi)鏡像源

# 清華鏡像源
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. 恢復(fù)默認(rèn)源

如果需要恢復(fù)官方源：

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

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

7. 使用多個(gè)鏡像源

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

[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