常用镜像站配置

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

  1. 在用户目录 C:\Users\用户名 下新建文件夹 pip
  2. 里面新建文件 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,Windows python -m pip install xxx,避免版本错乱。

Nodejs

国内镜像源

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com/

# 验证是否设置成功(应输出上述镜像地址)
npm config get registry