Mac上pip安装慢因默认用国外源,应切换国内镜像源:临时换源用pip install -i https://mirrors.aliyun.com/pypi/simple/;永久换源推荐pip config set命令,旧版可用手动创建~/.pip/pip.conf。

Mac上pip安装Python包总卡在“Collecting”阶段、报ReadTimeoutError或下载速度不到200KB/s,说明还在用默认的国外PyPI源。现在立刻切换到国内镜像源,5分钟内完成,装numpy这类大包从12分钟缩至25秒。
临时换源:单次安装加速
执行一条命令即可,不改任何配置文件,适合测试、CI环境或他人电脑上快速安装:
pip install requests -i https://mirrors.aliyun.com/pypi/simple/
这一步操作起来很简单,直接把命令复制粘贴进终端回车就行。注意-i参数必须紧挨着包名,中间不能有空格;如果提示“Command 'pip' not found”,请先用python3 -m pip install代替。
永久换源:命令行一键配置(推荐)
适用于pip 10.0及以上版本(2026年新装Python默认满足),无需手动建目录、写文件,出错率最低:
第一步:打开终端,输入以下命令设置阿里云源:
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
第二步:再执行这句,让pip信任该域名:
pip config set global.trusted-host mirrors.aliyun.com
第三步:验证是否生效:
pip config list
若输出中包含【global.index-url='https://mirrors.aliyun.com/pypi/simple/'】,说明已成功。注意:如果系统里装了多个Python(如python39/python312),需分别对对应pip执行上述三步,例如pip39 config set…
永久换源:手动创建配置文件(兼容旧版pip)
当pip版本低于10.0,或命令行配置报错“Config file not found”时使用此法。它绕过pip config机制,直接落盘生效:
方法一:终端执行三行命令,自动创建并写入(最省事):
mkdir -p ~/.pip && echo -e "[global]\nindex-url = https://pypi.tuna.tsinghua.edu.cn/simple/\ntrusted-host = pypi.tuna.tsinghua.edu.cn" > ~/.pip/pip.conf
方法二:手动编辑(适合想确认每行内容是否正确的人):
在终端输入open -e ~/.pip/pip.conf,系统会用文本编辑器打开该文件;若提示“文件不存在”,先执行mkdir -p ~/.pip再重试;粘贴以下内容保存:
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn
⚠️ 注意:macOS默认隐藏以.开头的文件夹,~/.pip不会在访达中直接显示,必须用终端创建或open命令打开;若误建在桌面或文档目录下,pip将完全忽略该文件。











