十二、Python 镜像源配置

本章目录
12.1 临时使用镜像源 12.2 永久修改镜像源 12.3 常用国内镜像源地址 12.4 查看当前镜像源配置 12.5 重置为官方镜像源 12.6 poetry 镜像源配置 12.7 pipenv 镜像源配置

12.1 临时使用镜像源 

# 使用国内镜像源安装单个包
pip install <包名> -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install <包名> -i https://mirrors.aliyun.com/pypi/simple/
pip install <包名> -i https://pypi.doubanio.com/simple/
pip install <包名> -i https://pypi.mirrors.ustc.edu.cn/simple/

# 示例
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

12.2 永久修改镜像源

方法一：pip config 命令（推荐） 

# 设置为清华大学镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 设置为阿里云镜像源
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/


# 设置信任主机（如果遇到 HTTPS 证书问题）
pip config set global.trusted-host mirrors.aliyun.com

方法二：手动修改配置文件

配置文件路径：

系统 路径
Linux / macOS ~/.pip/pip.conf 或 ~/.config/pip/pip.conf
Windows %APPDATA%\pip\pip.ini 或 C:\Users\<用户名>\pip\pip.ini
配置内容： 
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn

# 可选：指定备用镜像源
extra-index-url =
https://mirrors.aliyun.com/pypi/simple/
https://pypi.doubanio.com/simple/


# 可选：设置超时时间（秒）
timeout = 60

方法三：pip 命令修改（旧版本） 

# 直接在 pip 命令中指定镜像源（对当前命令有效）
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 设置环境变量（对当前会话有效）
export PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple

12.3 常用国内镜像源地址

镜像源 URL
清华大学 https://pypi.tuna.tsinghua.edu.cn/simple
阿里云 https://mirrors.aliyun.com/pypi/simple/
豆瓣 https://pypi.doubanio.com/simple/
中国科技大学 https://pypi.mirrors.ustc.edu.cn/simple/
华为云 https://mirrors.huaweicloud.com/repository/pypi/simple
腾讯云 https://mirrors.cloud.tencent.com/pypi/simple

12.4 查看当前镜像源配置 

pip config list                        # 列出所有配置
pip config get global.index-url        # 查看当前使用的镜像源地址
pip config debug                       # 查看详细配置信息

12.5 重置为官方镜像源 

pip config unset global.index-url      # 移除自定义镜像源，恢复为官方源

12.6 poetry 镜像源配置 

# pyproject.toml 中添加镜像源配置
[[tool.poetry.source]]
name = "mirrors"
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true

12.7 pipenv 镜像源配置 

# Pipfile 中配置镜像源
[[source]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
verify_ssl = true
name = "mirrors"