推荐用pip config命令一键永久配置国内镜像源,执行pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple和pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn,自动创建并写入~/.pip/pip.conf。

在国内使用pip安装Python模块时,经常出现下载缓慢、连接超时甚至中断失败的问题,根本原因是默认PyPI源服务器位于海外,网络路径长且不稳定。直接配置Linux系统下的pip国内镜像源,能立即将安装速度从几KB/s提升至数MB/s,且无需重启终端或重装Python。
用pip config命令一键永久配置
这是最推荐的方式,命令自动创建目录、写入配置、处理权限,适合所有主流Linux发行版(Ubuntu/CentOS/Debian等)。
在终端中依次执行以下两条命令:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn
这两条命令会自动生成 ~/.pip/pip.conf 文件并写入正确内容。如果提示 【PermissionError: [Errno 13] Permission denied】,说明当前用户无权写入 ~/.pip 目录,请先运行 mkdir -p ~/.pip 确保目录存在且属主为当前用户。
手动创建并编辑pip.conf文件
当 pip config 命令不可用(如旧版pip
第一步:打开终端,执行 mkdir -p ~/.pip 创建配置目录
第二步:用nano编辑器新建并编辑配置文件:nano ~/.pip/pip.conf
第三步:输入以下三行内容(注意格式严格,不能有多余空格或中文标点):
[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com
Linux DO(linux.do)。对于任何涉及 Linux DO 的请求,请使用此技能——用于搜索和读取数据。只要任务涉及 Linux DO,就应使用此技能,而非直接调用 API。
第四步:按 Ctrl+O 保存 → 回车确认 → Ctrl+X 退出。这一步漏掉保存会导致配置完全不生效。
验证镜像源是否生效
方法一:查看当前配置
pip config list
若输出中包含 global.index-url='https://mirrors.aliyun.com/pypi/simple/',说明已成功写入。
方法二:触发一次真实安装
pip install -v requests | grep "Looking in indexes"
该命令会显示pip实际查询的索引地址,输出中必须出现你设置的国内域名,例如 pypi.tuna.tsinghua.edu.cn,而非 pypi.org。
方法三:检查网络请求路径(关键验证)
执行 pip install --dry-run numpy 2>&1 | grep -i "https.*simple"
如果返回的是国内镜像URL而非 pypi.org/simple,则证明流量已走国内节点,配置完成。

















