优先修改用户级配置文件最稳妥，推荐清华源（https://pypi.tuna.tsinghua.edu.cn/simple/），Linux/macOS写入~/.pip/pip.conf，Windows写入%APPDATA%\pip\pip.ini，内容含index-url和trusted-host；临时换源用-i参数，如pip install pkg -i 清华源；pip≥21.1可用pip config set global.index-url --user配置。
pip install 时慢或超时，优先改全局配置
直接改用户级配置文件最稳妥，不影响系统其他用户，也不会被 pip 升级覆盖。清华源和豆瓣源都支持 HTTPS，地址稳定，但豆瓣源近年偶有同步延迟，推荐优先用清华源。
执行以下命令生成或编辑配置文件：
mkdir -p ~/.pip<br>echo "[global]\nindex-url = https://pypi.tuna.tsinghua.edu.cn/simple/\ntrusted-host = pypi.tuna.tsinghua.edu.cn" > ~/.pip/pip.conf
注意：~/.pip/pip.conf 是 Linux/macOS 下的路径；Windows 用户对应的是 %APPDATA%\pip\pip.ini。
临时换源只对单次命令生效
适合验证镜像是否可用，或在 CI/CD 脚本里避免污染环境。不用改任何配置文件，也不依赖用户权限。
常用写法：
- 用
-i指定源：pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/ - 加
--trusted-host避免 SSL 报错（部分旧版 pip 需要）：pip install flask -i https://pypi.douban.com/simple/ --trusted-host pypi.douban.com
豆瓣源地址是 https://pypi.douban.com/simple/，不是 http，少写一个 s 就会报 ConnectionError。
Linux 安全审计工具，检查 SSH 配置、开放/监听端口、防火墙规则（ufw/iptables/nftables）、失败登录尝试、sudoers 权限...
pip config 命令修改配置（pip ≥ 21.1）
新版 pip 内置了 config 子命令，比手动编辑文件更安全，能自动处理路径和格式。但它不会覆盖已有冲突项，得先确认当前配置来源。
操作步骤：
- 查当前生效配置：
pip config debug - 设全局源（写入 site 级配置，需 root）：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/ - 设用户级源（推荐）：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/ --user
注意：pip config 不会自动添加 trusted-host，HTTPS 源一般不需要；但如果用了自建镜像或旧证书环境，仍可能报 CertificateVerifyError，此时得手动补上。
镜像源失效或 pip 升级后配置丢失
清华源域名没变过，但偶尔因 DNS 或本地网络策略导致解析失败；豆瓣源曾短暂关闭又恢复，不建议长期用于生产环境。另外，某些 Docker 镜像或最小化 Linux 发行版（如 Alpine）默认没建 ~/.pip 目录，pip.conf 放进去也不会读——得用 pip config --user 或启动时加 -i。
验证是否生效最简单的方法是：
pip install -v some-package-that-does-not-exist 2>&1 | grep "Looking in indexes"
看到输出里出现 https://pypi.tuna.tsinghua.edu.cn/simple/ 就说明源已生效。别只看安装速度，有些包本地有缓存，即使源没切对也会“显得很快”。
