讲师中心 微信公众号
AI工具推荐 视频效率加速

如何永久修改pip的镜像源

酷宇吖_5300

酷宇吖_5300

发布时间:2026-09-02 09:41:46

|

830人浏览过

|

来源于php中文网

原创

永久修改 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 是不是你的镜像地址。

相关文章

相关标签:

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

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

2410

2023.10.09

更新pip版本
更新pip版本

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

5563

2024.12.20

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

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

7082

2024.12.23

python升级pip
python升级pip

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

3387

2025.07.23

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

0

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

0

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

0

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

0

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

0

2026.09.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python venv官方模块文档
Python venv官方模块文档

共0课时 | 0人学习

pip官方命令参考
pip官方命令参考

共0课时 | 0人学习

pip安装和使用保姆级教程
pip安装和使用保姆级教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn