【python】MacOS下永久配置pip镜像源

核心方法:修改 pip 的配置文件

在 macOS 上,您需要创建或修改一个位于用户主目录下的配置文件 pip.conf。


详细步骤

第一步:打开终端

  1. 按 Command + 空格键 打开 Spotlight 搜索。
  2. 输入"终端"或"Terminal",然后按回车键打开。

第二步:进入并创建配置目录

在终端中依次输入以下命令:

bash 复制代码
# 1. 进入您的主目录(~ 符号代表主目录)
cd ~

# 2. 创建 .pip 目录(如果已存在,会提示已存在,可忽略)
mkdir -p .pip

第三步:创建并编辑配置文件

现在,您需要创建 pip.conf 文件并写入镜像源配置。

方法 A:使用 nano 编辑器(推荐,简单易用)

bash 复制代码
# 使用 nano 编辑器创建并编辑文件
nano ~/.pip/pip.conf

这时会打开一个文本编辑器界面。

方法 B:使用 echo 命令直接创建(快速)

bash 复制代码
# 以配置「阿里云」镜像为例,将配置命令直接写入文件
echo -e "[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
[install]
trusted-host = mirrors.aliyun.com" > ~/.pip/pip.conf

执行此命令后,文件会自动创建并写入内容。如果您想使用其他镜像源,只需替换命令中的地址和 trusted-host 值即可(例如换成清华大学的地址)。


第四步:配置文件内容(如果您使用方法 A 编辑)

如果您使用了 nano 编辑器,在打开的文件中,手动输入以下内容(以阿里云镜像为例):

ini 复制代码
[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
[install]
trusted-host = mirrors.aliyun.com

内容说明:

  • [global]:全局配置节。
  • index-url:这是最重要的设置,指定了 pip 默认去哪个地址下载包。
  • [install]:安装配置节。
  • trusted-host:将镜像源的域名添加为可信主机,可以避免因 HTTPS 证书问题导致的警告或失败。

输入完毕后,按以下键保存并退出:

  1. 按 Control + O 键(保存)。
  2. 按 回车 键(确认文件名)。
  3. 按 Control + X 键(退出 nano)。

第五步:验证配置是否生效

在终端中输入以下命令进行测试:

bash 复制代码
pip install --upgrade pip

或者安装一个常用的小包来观察下载源:

bash 复制代码
pip install requests

观察命令输出的下载链接。如果开头显示的是 https://mirrors.aliyun.com/pypi/... 或您配置的其他镜像地址(而不是 https://files.pythonhosted.org/...),就说明配置成功了!


其他常用镜像源配置(替换上述地址即可)

  • 清华大学:

    ini 复制代码
    [global]
    index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
    [install]
    trusted-host = pypi.tuna.tsinghua.edu.cn
  • 腾讯云:

    ini 复制代码
    [global]
    index-url = https://mirrors.cloud.tencent.com/pypi/simple/
    [install]
    trusted-host = mirrors.cloud.tencent.com

重要提示与额外建议

  1. 作用范围 :此方法配置的是当前用户的 pip 设置。在该用户下运行的所有 pip 命令(包括在虚拟环境内,除非虚拟环境内有自己的配置)都会默认使用此镜像源。
  2. 虚拟环境 :如果您使用 venv 或 conda 创建了独立的虚拟环境,在激活虚拟环境后,pip 会优先使用虚拟环境内的配置。如果虚拟环境内没有配置,则会继承这里的用户级配置。您也可以进入虚拟环境后,用同样的方法在虚拟环境的目录里单独配置。
  3. 如果遇到问题 :
    • 检查文件路径和名称是否正确:~/.pip/pip.conf。
    • 检查文件内容格式,确保没有多余的空格或拼写错误。
    • 可以尝试换一个镜像源(如从阿里云换成清华)。

按照以上步骤操作,您就可以在 macOS 上永久解决 pip 下载慢的问题了。

相关推荐
oil欧哟2 天前
Oil Studio 的产品思路与日常使用方式:在 Mac 上录口播演示,并接入 AI Agent 精剪与自动录屏
人工智能·macos
prince_zxill3 天前
PEP 751 pylock.toml 实测:pip 26.3 装 6 个包版本全钉死,但 [web] 选不中任何东西
python·pip·依赖管理·pep 751
小毛球.3 天前
第 3 篇:IDEA 最新版下载与完整安装教程(Mac)
java·macos·intellij-idea·idea
CodeClimb5 天前
Mac 磁盘无法推出(DMG外接盘)排查处理教程
macos
Karl_fang5 天前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
2601_967979126 天前
pip在Python中的9个必须知道的用法
python·pip·版本控制·包管理工具·requirements.txt
csdn_aspnet7 天前
macOS 10 、Docker 玩轉 MySQL
运维·mysql·macos·docker·容器·mac
秋雨梧桐叶落莳7 天前
【iOS】Block底层详解
macos·ios·cocoa
2601_967979127 天前
纯手写:Python安装pip完整教程,搞了几小时,终于成功
python·教程·pip·安装·包管理
高调的涵涵8 天前
café 和 café 不是一个文件名
macos