清华源配置后无需重启终端,立即生效;临时换源用pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名,永久换源推荐pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple,PyCharm需单独设置。

直接改就行,不用重启终端,改完立刻生效。清华源(https://pypi.tuna.tsinghua.edu.cn/simple)目前响应稳定、同步及时,是多数国内用户的首选。
临时换源:只对当前命令起作用
适合测试、CI 脚本或不想动配置的场景。注意 -i 参数必须紧接在 pip install 后,且 URL 末尾不能漏掉 /simple:
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple
- 错误写法:
pip install -i https://pypi.tuna.tsinghua.edu.cn/ requests(URL 缺/simple,会报404 Client Error) - 错误写法:
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/(末尾多一个/,部分旧版 pip 会解析失败) - 如果提示
trusted-host错误,加--trusted-host pypi.tuna.tsinghua.edu.cn即可,但临时方式下不推荐长期依赖这个参数
永久换源:改配置文件或用 pip config
推荐优先用 pip config 命令,它自动适配系统路径,比手动建 pip.ini 或 pip.conf 更可靠:
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
- 执行后无需重启终端,下次
pip install就默认走清华源 - Windows 下该命令会写入
C:\Users\用户名\pip\pip.ini;Linux/macOS 写入~/.pip/pip.conf - 如果提示
Config file does not exist,说明目录还没创建,命令会自动补全,不用你手动 mkdir - 想确认是否生效?运行
pip config list,输出里必须有global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'
PyCharm 里也要单独设
IDE 不读取系统 pip 配置,得在界面里重设一次,否则点「Install Package」还是走默认源:
- File → Settings → Project → Python Interpreter → 右上角齿轮图标 → Manage Repositories
- 删掉默认的
https://pypi.org/simple,点击 + 添加:https://pypi.tuna.tsinghua.edu.cn/simple - 确保新地址被设为「Default」(带星标),否则安装时可能弹窗让你选源
- 改完别忘了点 OK 保存,有些版本不点 OK 不生效
最容易被忽略的是 PyCharm 和终端配置分离这件事——你在命令行改好了,IDE 里照样慢;反过来也一样。另外,清华源偶尔会因上游同步延迟导致新包暂不可见(比如刚发布的 torch 1.14),这时可以临时切阿里云源应急,不是所有镜像源同步节奏都一样。


















