常用镜像站配置
2026-08-14
pip install
1. 临时(单次生效)
安装包时加 -i 指定源,示例:
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple
常用国内源:
- 清华:
https://pypi.tuna.tsinghua.edu.cn/simple - 阿里云:
https://mirrors.aliyun.com/pypi/simple - 中科大:
https://pypi.mirrors.ustc.edu.cn/simple
如果出现 https 证书报错,加上参数
--trusted-host pypi.tuna.tsinghua.edu.cn
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn
2. 永久配置pip镜像源
Windows
- 在用户目录
C:\Users\用户名下新建文件夹pip - 里面新建文件
pip.ini,写入:
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
Linux / macOS
mkdir -p ~/.pip
vim ~/.pip/pip.conf
写入同样上面 ini 内容。
python3.10+ 也支持新路径:
~/.config/pip/pip.conf
配置完成后,直接 pip install xxx 就自动走国内源。
常见问题
pip / pip3:linux/mac 优先用
python3 -m pip install xxx,Windowspython -m pip install xxx,避免版本错乱。
Nodejs
国内镜像源
# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com/
# 验证是否设置成功(应输出上述镜像地址)
npm config get registry