pip怎么设置源快速上手指南

在使用Python进行开发时，pip是一个不可或缺的包管理工具。然而，默认的pip源下载速度在国内可能会比较慢。通过设置国内的镜像源，可以显著提高包的下载和安装速度。这篇指南将详细讲解如何在Linux和Windows系统中设置pip源，从临时修改到永久配置，为您提供一劳永逸的解决方案。

了解pip源的重要性

pip源的作用是什么

在使用Python安装包工具pip时，经常会出现下载速度缓慢的问题。这主要是因为pip的默认源https://pypi.org/simple在国内访问速度较慢。为了提高包的下载速度，我们可以使用国内的镜像源。

PYPI国内源路径

• 阿里云: http://mirrors.aliyun.com/pypi/simple/
• 中国科技大学: https://explinks-blog.oss-cn-beijing.aliyuncs.com/md/2025/03/3ea1c8d079b38532a6e01a96216ba5e2.jpg
• 豆瓣(douban): http://pypi.douban.com/simple/
• 清华大学: https://pypi.tuna.tsinghua.edu.cn/simple/

为什么需要更换pip源

更换pip源可以显著提高包的下载速度，尤其在国内网络环境下。使用国内源可以避免因为网络问题导致的下载失败或速度极慢的情况。

换源方式

我们提供两种换源的方式：临时换源和永久换源。

临时换源

临时换源只需要在pip安装包时，加上一个 -i 参数后接源的URL即可。例如，使用豆瓣源下载Django包：

pip install django -i http://pypi.douban.com/simple

永久换源（更换默认源）

对于Linux系统，可以在根目录下创建或修改 ~/.pip/pip.conf 文件，内容如下：

[global]
index-url=http://pypi.douban.com/simple
[install]
trusted-host=pypi.douban.com

对于Windows系统，可以在 C:Users你的帐户名pippip.ini 文件中添加以下内容：

[global]
index-url=http://mirrors.aliyun.com/pypi/simple/
[install]
trusted-host=mirrors.aliyun.com

常见问题

在安装包时，如果出现以下错误：

Collecting beautifulsoup4
The repository located at mirrors.aliyun.com is not a trusted or secure host and is being ignored...

这是因为pip镜像未被信任，只需添加信任源即可。例如，临时换源时可以这样处理：

pip install beautifulsoup4 --trusted-host mirrors.aliyun.com

永久换源时，可以在配置文件中添加信任源：

[install]
trusted-host=pypi.douban.com

通过更换pip源，可以大大提高Python包的下载和安装效率，尤其在国内网络环境下，使用国内镜像源是一个非常有效的解决方案。

临时更改pip源的方法

使用-i参数临时指定源

在使用pip安装Python包时，我们可以通过使用-i参数临时指定源。此方法非常适合在需要快速下载特定包而不更改默认配置时使用。下面是一个示例，使用清华大学的镜像源来安装requests包：

pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

此方法的优势是简单快捷，适合偶尔需要切换源的场景，避免了对系统配置的永久性更改。

适用场景及注意事项

临时更改pip源的方法适用于以下场景：

1. 快速下载单个或少量包：当您需要临时使用某个国内镜像源来提高下载速度时，可以使用此方法。

2. 避免长期配置更改：此方法不会影响pip的默认源设置，因此适合不希望更改系统配置的用户。

注意事项：

• 临时更改源不会保存设置，仅在当前命令有效。
• 选择镜像源时，请确保使用HTTPS协议的源以提高安全性。

在使用过程中，如果遇到镜像未被信任的提示，可以使用--trusted-host参数来指定信任源，例如：

pip install requests --trusted-host pypi.tuna.tsinghua.edu.cn

这种方法可以解决因源不被信任而导致的安装问题。

在Linux系统中永久更改pip源

创建或修改pip配置文件

要在Linux系统中永久更改pip源，我们需要创建或修改pip的配置文件。在用户的主目录下创建或者编辑 ~/.pip/pip.conf 文件。

配置文件中需要填写的内容

在配置文件中添加如下内容，以使用清华大学的镜像源为例：

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

这样，所有通过pip安装的Python包将默认从清华大学的镜像源下载。这个方法不仅能提高下载速度，还能避免网络问题导致的安装失败。

此外，如果需要使用其他镜像源，只需将index-url和trusted-host的值更改为对应的URL即可。例如，使用阿里云的镜像源，可以将配置文件修改为：

[global]
index-url = https://mirrors.aliyun.com/pypi/simple/
[install]
trusted-host = mirrors.aliyun.com

通过这种方式，我们可以确保在Linux系统中pip源的永久更改，从而提高包管理的效率和稳定性。

在Windows系统中永久更改pip源

找到pip.ini文件的位置

在Windows系统中，要永久更改pip源，我们需要找到并编辑pip的配置文件pip.ini。该文件通常位于：

C:Users你的帐户名pippip.ini

如果该文件夹或文件不存在，可以手动创建。

正确填写pip.ini的内容

找到或创建pip.ini文件后，我们需要在其中添加或修改如下内容，以使用清华大学的镜像源为例：

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

这段配置文件内容将指定pip默认从清华大学镜像源下载Python包，并且将该镜像源设置为受信任的主机。

如果需要使用其他镜像源，只需将index-url和trusted-host的值更改为对应的URL即可。例如，使用阿里云的镜像源，可以将配置文件修改为：

[global]
index-url = http://mirrors.aliyun.com/pypi/simple/
[install]
trusted-host = mirrors.aliyun.com

通过这种方式，我们可以确保在Windows系统中pip源的永久更改，从而提高包管理的效率和稳定性。

此外，如果在安装包时遇到镜像未被信任的提示，可以使用--trusted-host参数来指定信任源，例如：

pip install requests --trusted-host pypi.tuna.tsinghua.edu.cn

这种方法可以解决因源不被信任而导致的安装问题。

验证pip源的设置

如何检查当前的pip源

要验证当前的pip源设置，可以使用命令行查看当前的配置文件内容。首先，查看当前的pip源配置，您可以使用以下命令：

pip config list

此命令会显示当前pip的配置，包括使用的索引URL和信任的主机等信息。如果需要查看特定的配置文件路径，可以通过以下命令获取：

pip config --user

这将显示用户级别的配置文件路径，通常会列出与pip相关的所有配置。

测试下载速度的变化

为了测试更改pip源后的下载速度差异，可以尝试安装一个常用的包，并计时下载过程。例如，使用time命令来测试从不同源下载requests包所需的时间：

time pip install requests -i https://pypi.mirrors.ustc.edu.cn/simple

通过更换不同的源重复上述步骤，例如切换到清华大学的镜像源：

time pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

比较不同源的下载时间，可以帮助确定哪个源在当前网络环境下提供更快的下载速度。

通过这种方式，用户可以有效评估不同pip源的性能，从而选择最适合自己的源，以提高下载和安装Python包的效率。

常见问题和解决方案

处理源不受信任的警告

在使用pip安装Python包时，有时会遇到源不被信任的警告信息。这可能是因为pip镜像未被信任，解决这个问题的一个简单方法是使用--trusted-host参数来信任该源。例如，当使用中国科技大学的镜像源下载包时，可能会出现以下错误：

Collecting beautifulsoup4
The repository located at mirrors.aliyun.com is not a trusted or secure host and is being ignored...

可以通过以下命令来解决这个问题：

pip install beautifulsoup4 --trusted-host pypi.mirrors.ustc.edu.cn

这种方法可以临时解决镜像源不受信任的问题，确保包能够顺利安装。

解决下载速度慢的问题

使用Python的pip工具安装包时，可能会因为默认的国外源导致下载速度较慢。为了解决这个问题，我们可以使用国内的镜像源来加速下载。以下是使用中国科技大学镜像源的方法：

pip install requests -i https://pypi.mirrors.ustc.edu.cn/simple

通过设置国内镜像源，可以显著提高包的下载速度，尤其是在国内网络环境下。使用国内源不仅能提高速度，还能避免网络问题导致的安装失败。

这种方法适合需要快速下载多个包的情况，并且可以通过配置文件永久更改pip源，以便所有包都能从国内镜像源下载。通过这种方式，我们可以确保pip的高效运行和稳定性。