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

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

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

详细步骤

第一步：打开终端

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

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

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

# 1. 进入您的主目录（~ 符号代表主目录） cd ~ # 2. 创建 .pip 目录（如果已存在，会提示已存在，可忽略） mkdir -p .pip

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

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

方法 A：使用nano编辑器（推荐，简单易用）

# 使用 nano 编辑器创建并编辑文件 nano ~/.pip/pip.conf

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

方法 B：使用echo命令直接创建（快速）

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

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

第四步：配置文件内容（如果您使用方法 A 编辑）

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

[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）。

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

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

pip install --upgrade pip

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

pip install requests

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

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

• 清华大学：

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

• 腾讯云：

  [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 下载慢的问题了。