0

0

Python如何配置国内源_pip永久更改清华与阿里云镜像源

P粉602998670

P粉602998670

发布时间:2026-03-19 10:39:11

|

193人浏览过

|

来源于php中文网

原创

pip install 超时或缓慢是因默认连接不稳定国外 PyPI 官方源,改用清华或阿里云镜像源并配置当前用户 pip.conf 可永久加速,注意 trusted-host 须与 index-url 域名一致且以 /simple/ 结尾。

python如何配置国内源_pip永久更改清华与阿里云镜像源

pip install 为什么总超时或慢得像爬虫

因为默认走的是 PyPI 官方源 https://pypi.org/simple/,国内直连不稳定,DNS 解析慢、连接经常中断,pip install 卡在 “Collecting …” 就是典型表现。

临时加 -i 参数能绕过,但每次敲命令都写一遍不现实;改配置文件才是永久解法。关键不是“能不能换”,而是“换完会不会影响其他环境”。

  • 全局配置(所有用户)写进 /etc/pip.conf(Linux/macOS)或 %PROGRAMDATA%\pip\pip.ini(Windows)
  • 当前用户配置更安全,路径是 $HOME/.pip/pip.conf(Linux/macOS)或 %APPDATA%\pip\pip.ini(Windows)
  • 优先级:当前用户 > 全局 > 命令行参数,推荐只动当前用户配置,避免污染系统或其他虚拟环境

清华源和阿里云源怎么选,配置格式有啥区别

两个源都稳定,但细节不同:https://pypi.tuna.tsinghua.edu.cn/simple/ 是清华主站,https://mirrors.aliyun.com/pypi/simple/ 是阿里云镜像。它们都不需要认证,但必须以 /simple/ 结尾,少这个后缀会报 404 Not Found 或直接退回到官方源。

配置内容极简,不要加空格、注释或多余换行,否则 pip 会静默忽略整段:

立即学习Python免费学习笔记(深入)”;

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
trusted-host = pypi.tuna.tsinghua.edu.cn

如果用阿里云源,把两行里的 pypi.tuna.tsinghua.edu.cn 全换成 mirrors.aliyun.com 即可。注意 trusted-host 必须和 index-url 域名一致,否则 HTTPS 证书校验失败,报错 Could not fetch URL ... There was a problem confirming the ssl certificate

Hypotenuse AI
Hypotenuse AI

AI写作助手和文本生成器,根据关键词生成原创的、有洞察力的文章

下载

virtualenv 或 conda 环境里 pip 源还生效吗

生效,但有条件:只要没在该环境下单独配置过 pip 配置文件,就继承当前用户的配置。容易踩的坑是——有人在虚拟环境中执行了 pip config set global.index-url ...,结果只改了该环境的配置,切出去就失效。

  • 检查当前生效配置:运行 pip config list,看输出里有没有 global.index-url
  • 查配置来源:用 pip config debug,它会列出所有被读取的配置文件路径及优先级
  • conda 环境默认用 conda 自己的包管理,但如果你用 pip install 装非 conda 包,依然走 pip 的配置

换源后 pip search 报错或返回空,正常吗

正常。pip search 早在 pip 10.0 就被官方禁用了,因为后端服务下线,现在所有镜像源都不支持这个命令。这不是你配错了,是功能本身没了。别折腾修复,改用 pip show <包名> 查已装包,或直接去 https://pypi.org/project/<包名>/ 页面搜。

另一个常见现象:换源后 pip install 第一次仍慢,是因为 pip 会缓存索引,下次才明显快。如果某次安装突然又卡住,先 pip cache info 看缓存位置,再 pip cache purge 清一下,比怀疑配置更有效。

最易被忽略的一点:某些公司内网会劫持 DNS 或强制代理,即使你配了清华源,请求也可能被重定向到内部镜像——这时要确认 pip install -v requests 输出里实际请求的 URL 是不是你写的那个地址。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

781

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

697

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

784

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

890

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1564

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

598

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

591

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

759

2023.08.11

bootstrap安装教程
bootstrap安装教程

本专题整合了bootstrap安装相关教程,阅读专题下面的文章了解更多详细操作教程。

22

2026.03.18

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 5.1万人学习

SciPy 教程
SciPy 教程

共10课时 | 2万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号