永久修改 pip 镜像源最可靠方式是用 pip config set 命令写入用户级配置,自动处理跨平台路径与权限问题,命令为 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple。

永久修改 pip 镜像源,最可靠的方式是用 pip config set 命令写入用户级配置,而不是手动编辑文件——后者容易因路径错误或权限问题失效。
用 pip config set 写入用户配置(推荐)
这是当前 pip(≥21.0)官方支持的首选方式,自动处理跨平台路径、文件创建和权限问题:
-
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple会把配置写入用户目录下的pip.conf(Linux/macOS)或pip.ini(Windows),无需手动找路径 - 加
--user参数是默认行为,不加也生效;加--global会尝试写系统级配置(Linux/macOS 需sudo,Windows 常因权限失败,不建议) - 如果命令报错
No such file or directory: '/path/to/pip.conf',说明 pip 版本太低(python -m pip install --upgrade pip - 执行后可用
pip config list验证是否写入成功,输出中应含global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'
手动创建配置文件(备用方案)
当 pip config 不可用(如旧版 pip 或 CI 环境限制命令执行)时,才考虑手动建文件:
从QuickView趋势笔记生成韩语AI播客包,含双人主持脚本(Callie×Nick)、Gemini多说话人TTS音频、字幕时间轴与渲染修正、缩略图+MP4包装及YouTube标题/描述输出。支持完整版(15~20分钟)和压缩版(5~7分钟)。
- Linux/macOS:在
~/.pip/pip.conf中写入:[global] index-url = https://mirrors.aliyun.com/pypi/simple/
注意.pip是隐藏目录,若不存在需mkdir -p ~/.pip - Windows:在
%APPDATA%\pip\pip.ini(例如C:\Users\用户名\AppData\Roaming\pip\pip.ini)中写入相同内容;路径不存在就新建pip文件夹 - 不要往
/etc/pip.conf(Linux)或 Python 安装目录下写,那属于系统级配置,普通用户无权修改,且可能被包管理器覆盖
常见镜像源地址和证书问题
国内主流镜像源地址必须带 https 协议,但部分网络环境会校验失败:
- 清华源:
https://pypi.tuna.tsinghua.edu.cn/simple/ - 阿里云:
https://mirrors.aliyun.com/pypi/simple/ - 豆瓣:
http://pypi.douban.com/simple/(注意是http,不用证书,但稳定性略低) - 若用清华或阿里源报
SSLError或Certificate verify failed,可在配置中追加信任主机:pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn(每换一个源,就得加对应trusted-host)
PyCharm 和虚拟环境是否继承?
是的,但有前提:
- PyCharm 的 Project Interpreter 默认调用系统
pip,只要该pip的用户配置已生效,PyCharm 就自动走镜像源 - 虚拟环境中,
pip会优先读取虚拟环境所在 Python 解释器的用户级配置(即你刚设的那个),不是继承 base 环境的pip配置 - 唯一例外:用
venv创建的虚拟环境若指定--system-site-packages,且 base 环境 pip 未配置,则可能 fallback 到默认源——此时建议在虚拟环境中单独运行一次pip config set
最容易被忽略的是 trusted-host 配置缺失导致的静默失败:pip 可能卡住几秒后回退到默认源下载,你以为换源成功了,其实没走镜像。验证时别只看命令是否返回成功,一定要 pip install -v some-package 看日志里实际请求的 URL 是不是你的镜像地址。










