方法 1:临时使用镜像源(单次下载)
在 pip install
命令后直接指定镜像源 URL(以清华源为例):
bash
pip install [包名] -i https://pypi.tuna.tsinghua.edu.cn/simple/
例如安装 numpy
:
bash
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple/
注意事项:
- 若遇到 SSL 证书验证问题,可添加
--trusted-host
参数:
bash
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn
方法 2:永久配置镜像源(推荐)
修改 pip
的全局配置文件,避免每次手动指定源。
步骤:
- 创建或修改配置文件:
- Windows:
在文件资源管理器地址栏输入%APPDATA%
,进入该目录后创建pip
文件夹,并在其中创建pip.ini
文件,内容如下:
ini
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
trusted-host = pypi.tuna.tsinghua.edu.cn
- Linux/MacOS:
在终端中执行以下命令:
bash
mkdir -p ~/.pip
echo -e "[global]\nindex-url = https://pypi.tuna.tsinghua.edu.cn/simple/\ntrusted-host = pypi.tuna.tsinghua.edu.cn" > ~/.pip/pip.conf
- 验证配置:
运行以下命令查看当前配置:
bash
pip config list
输出应包含:
global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple/'
其他镜像源替换
将上述配置中的 index-url
替换为其他镜像源地址即可:
- 阿里云:
http://mirrors.aliyun.com/pypi/simple/
- 中科大:
http://pypi.mirrors.ustc.edu.cn/simple/
- 华为云:
https://repo.huaweicloud.com/repository/pypi/simple/
首次安装 pip(若未安装)
如果系统未安装 pip
,可下载 get-pip.py
并通过镜像源安装:
bash
# 下载安装脚本
curl -O https://bootstrap.pypa.io/get-pip.py
# 使用清华源安装 pip
python get-pip.py -i https://pypi.tuna.tsinghua.edu.cn/simple/
升级 pip 至最新版
bash
pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple/
通过上述配置,pip
将默认使用国内镜像源,大幅提升下载速度并避免网络问题。