清华源稳定快速且支持HTTPS,推荐临时用-i参数或永久用pip config set配置;需验证pip config list输出及安装日志确认生效,旧版pip需先升级。

直接换,别犹豫——清华源现在稳定、快、支持 HTTPS,99% 的国内用户用它没出过问题。
临时换源:装包时加 -i 参数就行
只装一次包?不想动配置?直接在命令里指定源最干净。
-
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple—— 注意末尾必须是/simple,少一个斜杠会报404 Not Found - 如果遇到
Could not fetch URL或SSLError,大概率是没加trusted-host,但临时命令不用管这个,-i本身会绕过部分校验 - 不推荐把
-i写进脚本长期用,容易漏掉、难维护,也容易误传到 CI 环境里引发权限或网络策略问题
永久换源:用 pip config set 最可靠
比手动改配置文件更安全,自动处理路径、编码、权限,还能跨平台生效。
构建并发布在 Quartz 平台上的韩语网络小说连载(草稿→封面→webp→章节 md→lint→发布),使用 Nano Banana Pro + ffmpeg。
- 运行
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple - 顺手加上备用源(防止单点故障):
pip config set global.extra-index-url "https://mirrors.aliyun.com/pypi/simple https://pypi.mirrors.ustc.edu.cn/simple"—— 注意引号和空格,多个地址必须用空格分隔 - 执行后立刻生效,不用重启终端,也不用改环境变量
- 如果提示
Config file does not exist,别慌,pip config会自动创建,不需要你提前建目录或文件
验证和排错:看到 index-url 才算成功
别凭感觉,用命令确认真实生效的配置。
- 运行
pip config list,输出里必须有类似global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'的行 - 如果看到
global.index-url='https://pypi.org/simple',说明旧配置还在起作用,可能是你之前在pip.ini或pip.conf里写过冲突项,得手动删掉对应行 - 执行
pip install --dry-run requests(Python 3.12+ 支持),看日志里请求的是不是清华域名;老版本可用pip install -v requests | grep "https://pypi.tuna" - 偶尔会遇到 pip 版本太老(比如
pip < 21.0)不识别pip config命令,先升级:python -m pip install --upgrade pip
最容易被忽略的一点:清华源的 trusted-host 在新版 pip(≥22.0)里已不再强制要求写入配置,但如果你用的是企业内网或自建代理,仍可能因 SSL 中间人拦截失败——这时才需要额外加 pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn。

















