如何永久修改pip的镜像源

酷宇吖_5300

酷宇吖_5300

2026-09-02

810人浏览

原创

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

如何永久修改pip的镜像源

永久修改 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 环境限制命令执行)时,才考虑手动建文件:

Ai Podcast Pipeline
Ai Podcast Pipeline

从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,不用证书,但稳定性略低)
  • 若用清华或阿里源报 SSLErrorCertificate 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 是不是你的镜像地址。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

pip命令 pip 镜像源

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

2370

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

5483

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

7002

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

3327

16

NumPy性能优化版本更新与常见报错排查
NumPy性能优化版本更新与常见报错排查

本专题整理 NumPy 性能优化、版本更新与常见报错排查相关教程,覆盖向量化计算、广播性能、内存布局、NumPy 2.0 升级、版本兼容冲突、安装导入报错、dtype 溢出、矩阵运算异常和 broadcasting 报错修复,帮助读者系统掌握 NumPy 性能调优与问题定位方法。

2026.09.22

0

25

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

2026.09.21

20

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

20

24

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

2026.09.21

0

20

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

2026.09.21

0

17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Conan 2 安装指南
Conan 2 安装指南

共0课时 | 0人学习

Python虚拟环境官方教程
Python虚拟环境官方教程

共0课时 | 0人学习

Python venv官方模块文档
Python venv官方模块文档

共0课时 | 0人学习