【Python】pip命令安装包使用阿里云腾讯云等镜像源加速指南

单次加速指南

使用 pip 命令加速

在 Terminal 或 Jupyter 等终端环境中，通过指定 Python 包索引的镜像源来加速 pip 的下载速度。

1. 命令格式及参数解释：

pip install -i 镜像源地址 --trusted-host 镜像源域名 包名

• pip install：pip 的命令用于安装 Python 包。
• -i 或 –index-url 镜像源地址：指定 Python 包的下载源，通常是一个 URL。
• –trusted-host 镜像源域名：将指定的域名添加到信任的主机列表，允许 pip 从该域名下载包。

2. 阿里云 镜像示例：

pip install -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com numpy

3. 腾讯云 镜像示例：

pip install -i https://mirrors.cloud.tencent.com/pypi/simple --trusted-host mirrors.cloud.tencent.com numpy

4. 镜像源列表：

可以根据自己的地理位置和网络条件选择最合适的镜像源：

阿里云：https://mirrors.aliyun.com/pypi/simple/
腾讯云:：https://mirrors.cloud.tencent.com/pypi/simple/
清华大学：https://pypi.tuna.tsinghua.edu.cn/simple/
华为云:：https://mirrors.huaweicloud.com/repository/pypi/simple/
网易:：https://mirrors.163.com/pypi/simple/

5. 注意点：

• 确保替换为镜像源的实际地址和域名。
• 某些镜像源可能需要网络代理或特殊配置才能访问。
• 使用加速命令时，建议在网络状况良好的环境下进行，以充分利用加速效果。

使用Python解释器加速

如果需要指定 Python 解释器的完整路径来执行 pip 命令，尤其是在系统中存在多个 Python 版本时。

1. 命令格式及参数解释：

/path/to/python3 -m pip install -i 镜像源地址 --trusted-host 镜像源域名 包名

• /path/to/python3：系统中 Python 解释器的完整路径。
• -m pip：使用 Python 解释器执行 pip 模块。
• -i 或 –index-url 镜像源地址：同上，指定 Python 包的下载源。
• –trusted-host 镜像源域名：同上，指定信任的主机域名。

2. 如何找到Python解释器路径：

为了找到您系统中 Python 解释器的完整路径，可以使用以下方法：

• 在终端中使用 which python3（或 which python，取决于系统配置）来查找 Python 解释器的位置。
• 如果 which 命令不可用，可以使用 type python3 或 type python 来尝试获取路径。
• 一旦找到 Python 解释器的路径，就可以使用该路径来执行 pip 命令，从而确保使用特定版本的 Python。

3. 示例 (替换 /path/to/python3 为实际路径)：

/usr/local/bin/python3 -m pip install -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com numpy

4. 注意点：

• 使用 -m pip 确保使用与 Python 解释器相匹配的 pip 模块。
• 替换 /path/to/python3 为系统中 Python3 解释器的实际路径。

通过上述两种方法，可以根据需要选择使用 pip 命令或者指定 Python 解释器的路径来加速包的下载和安装过程。

永久加速指南

Windows 用户：

pip 配置文件

1. 修改pip配置文件

• 创建pip文件夹和配置文件：

  • 打开文件资源管理器，导航到 C:\Users\用户名\目录。
  • 如果没有 pip 文件夹，右键点击并选择”新建“ -> “文件夹”，创建一个名为 pip 的文件夹。
  • 在 pip 文件夹内，右键点击空白处，选择“新建” -> “文本文档”，创建一个名为 pip.ini 的文件。

• 编辑 pip.ini 文件：

  • 右键点击 pip.ini 文件，选择“打开方式”，然后选择“记事本”或其他文本编辑器。
  • 在 pip.ini 文件中输入以下内容，并替换 trusted-host 和 index-url 的值为选择的镜像源地址：

[global]
trusted-host = pypi.tuna.tsinghua.edu.cn;mirrors.aliyun.com;mirrors.cloud.tencent.com
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
extra-index-url =
 https://mirrors.aliyun.com/pypi/simple/
 https://mirrors.cloud.tencent.com/pypi/simple/

• 注意：
  • 配置多个镜像源：在 pip.ini 文件中，可以通过设置 index-url 来指定默认镜像源，并通过 extra-index-url 添加备用镜像源列表，每行一个 URL，确保在默认源不可用时 pip 可以自动尝试备用源。
  • 受信任的主机：使用 trusted-host 来声明您信任的镜像源主机名，多个主机名之间使用分号(;)分隔，以确保 pip 能够从这些镜像源安全地下载包。
  • 命令行优先级：如果在命令行中使用 -i 参数临时指定了镜像源，该镜像源将优先于 pip.ini 文件中配置的镜像源，用于当前的 pip 命令执行。同时，确认配置文件中的 URL 是准确且服务可用的。

2. 添加系统环境变量

• 打开系统属性：

  • 右键点击“此电脑”或“计算机”图标，选择“属性”。
  • 在打开的窗口中，点击左侧的“高级系统设置”。

• 环境变量：

  • 在“系统属性”窗口中，点击“环境变量”。

• 编辑系统变量：

  • 在“系统变量”区域，滚动找到名为“Path”的变量，选择它，然后点击“编辑”。
  • 在“编辑环境变量”窗口中，点击“新建”，然后添加pip文件夹路径，即 %HOME%\pip。

• 保存更改：

  • 应用所有更改，关闭所有剩余的系统属性窗口。

• 确保环境变量生效：

  • 为了使更改生效，可能需要重启计算机或重启命令行窗口。

PyCharm 中添加镜像源

1. PyCharm 2022之前版本：

• 打开设置：点击 File > Settings (对于 Mac 用户是 PyCharm > Preferences)。
• 选择项目设置：在设置窗口的左侧菜单中，选择 Project:项目名。
• 进入 Python 解释器设置：点击右侧的 Python Interpreter。
• 查看所有解释器：点击页面右下角的 Show All…。
• 管理仓库：点击 Manage Repositories 或者页面中的 + 号图标。
• 添加镜像源：在弹出的对话框中，输入镜像源的名称和 URL 地址，然后点击 OK。

2. PyCharm 2022版本：

• 打开 Python Packages：在 IDE 的左下角找到并点击 Python Packages 按钮。
• 进入设置：点击界面右上角的 Settings（齿轮图标）。
• 添加新的镜像源：点击弹出窗口中的 + 号。
• 输入镜像源信息：在弹出的对话框中，输入镜像源的名称和 URL 地址。
• 保存设置：点击 OK 或者 Apply 来保存设置。

3. 通用步骤（可能适用于多个版本）：

• 打开 PyCharm：启动 PyCharm 并打开项目。
• 进入设置：通过顶部菜单栏选择 File > Settings 。
• 选择 Python 解释器：在左侧菜单中选择 Project: 项目名 > Python Interpreter。
• 管理解释器：选择需要添加镜像源的 Python 解释器。
• 展开更多选项：点击齿轮图标，选择 Show All… 或 Manage Repositories。
• 添加镜像源：点击 + 号（添加按钮），输入新的镜像源 URL。
• 完成设置：确认添加后，关闭设置窗口。

4. 特别说明：

• 在添加镜像源时，可能需要指定一个名称来帮助识别这个镜像源。
• 某些 PyCharm 版本可能在界面布局和步骤上有所不同，但基本的操作逻辑是相似的。
• 如果在操作过程中遇到任何问题，可以查看 PyCharm 的帮助文档或在线搜索具体版本的操作指南。

VSCode 中添加镜像源

1. 打开设置

• 在 VSCode 中，点击左下角的齿轮图标，选择“设置”（Settings），或使用快捷键 Ctrl + ,（Windows/Linux）和 Cmd + ,（Mac）。

2. 搜索Python设置

• 在设置界面的搜索框中输入“Python Pip”，以过滤与Python相关的设置。

3. 修改设置

• 在搜索结果中找到 “Python: Pip Path” 和 “Python: Extra Care Package Index URL”（或类似的设置项）。

4. 配置镜像源

• 对于 “Python: Extra Care Package Index URL” ，这是添加额外的 pip 包索引 URL 的地方。点击旁边的“编辑在设置 .json 中”链接。

5. 编辑settings.json文件

• 在打开的 settings.json 文件中，需要添加一个新的条目来指定镜像源。在花括号 {} 内，添加如下内容：

"python.ExtraCarePackageIndexUrl": "https://mirrors.aliyun.com/pypi/simple/"

• 确保 settings.json 文件格式正确，没有语法错误。

6. 保存并关闭

• 保存对 settings.json 文件的更改，并关闭该文件。

7. 验证配置

• 为了验证配置是否生效，可以在 VSCode 的终端中运行 pip install 命令安装某个包，VSCode 的 Python 扩展应该会自动使用在设置中指定的镜像源。

8. 注意：

• 如果想要永久更改系统级的 pip 配置，需要在系统命令行中使用 pip config set global.index-url 命令来设置全局的镜像源。
• 在 VSCode 中配置的镜像源只会影响 VSCode 的终端中通过 Python 扩展执行的 pip 命令。

Linux用户：

方法一：使用用户级别的配置文件

1. 创建配置文件夹（如果还不存在）：

mkdir -p ~/.pip/

2. 创建或编辑配置文件：

touch ~/.pip/pip.conf

3. 编辑 pip.conf 文件，使用文本编辑器，如 nano 或 vim ：

vim ~/.pip/pip.conf

• 在 pip.conf 文件中添加以下内容：

[global]
trusted-host = pypi.tuna.tsinghua.edu.cn;mirrors.aliyun.com;mirrors.cloud.tencent.com
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
extra-index-url =
 https://mirrors.aliyun.com/pypi/simple/
 https://mirrors.cloud.tencent.com/pypi/simple/

• 保存并退出编辑器。

方法二：使用系统级别的配置文件

1. 找到或创建系统级别的 pip 配置文件，通常位于 /etc/pip.conf 或 /etc/pip/pip.conf。

2. 编辑系统级别的 pip.conf 文件，可能需要使用 sudo 来获取必要的权限：

sudo vim /etc/pip.conf

• 在文件中添加或修改内容，与用户级别的配置类似。
• 保存并退出编辑器。

方法三：通过环境变量

1. 使用 export 命令设置环境变量，这将只在当前终端会话中有效：

export PIP_DEFAULT_PIP_INDEX_URL="https://mirrors.aliyun.com/pypi/simple/"

2. 要使环境变量永久生效，可以将 export 命令添加到 shell 配置文件中，如 .bashrc 或 .bash_profile：

echo 'export PIP_DEFAULT_PIP_INDEX_URL="https://mirrors.aliyun.com/pypi/simple/"' >> ~/.bashrc

3. 重新加载配置文件，使更改生效：

source ~/.bashrc

方法四：使用pip的配置命令

1. 使用 pip config 命令设置默认的镜像源：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

这将修改 ~/.pip/pip.conf 文件，但请注意，使用 pip 的 config 命令可能不会创建 trusted-host 条目，这在某些私有或自签名证书的镜像源中是必需的。

注意事项

1. 根据地理位置、网络条件以及对镜像源速度和稳定性的需求，选择一个合适的镜像源。
2. 确保拥有修改系统级别配置文件的权限，如果没有，使用用户级别的配置文件即可。
3. 选择适合需求的方法，并根据使用的 shell 和系统环境进行适当的调整。

pip常用方法

安装包

1. 安装最新版本的包：

pip install 包名

2. 安装特定版本的包：

pip install 包名==版本号

2. 安装包时使用特定的镜像源：

pip install -i 镜像源URL 包名

更新包

1. 更新一个已安装的包到最新版本：

pip install --upgrade 包名

2. 更新pip到最新版本：

pip install --upgrade pip

2. 更新所有过时的包：

pip list --outdated --format=freeze | xargs -n 1 pip install --upgrade

安装选项

1. 安装包时不安装依赖：

pip install --no-deps 包名

2. 安装包时忽略安装过程中的依赖链接损坏：

pip install --ignore-installed 包名

2. 安装包时使用用户权限（不使用sudo）：

pip install --user 包名

3. 安装包时指定安装路径：

pip install --target=安装路径 包名

安全性选项

1. 安装包时允许从不安全的源下载：

pip install --trusted-host 镜像源URL 包名

2. 安装包时增加安全措施，比如SSL：

pip install --ssl 包名

包管理与依赖

1. 列出所有已安装的包及其版本：

pip list

2. 列出当前用户安装的所有包：

pip list --user

3. 查找可以更新的包：

pip list --outdated

4. 导出所有已安装包及其版本的列表到文件：

pip freeze > requirements.txt

5. 从 requirements.txt 文件安装包：

pip install -r requirements.txt

包信息与搜索

1. 显示包的详细信息：

pip show 包名

2. 搜索包（根据包名关键词）：

pip search 关键词

包卸载

1. 卸载一个包：

pip uninstall 包名

2. 强制卸载包（即使它被其他包依赖）：

pip uninstall -y 包名

配置管理

1. 查看当前pip的配置：

pip config list

2. 设置默认的源为特定的镜像源：

pip config set global.index-url 镜像源URL

2. 添加信任的源，以避免安全警告：

pip config set global.trusted-host 镜像源URL

高级使用

1. 检查已安装包的依赖是否得到满足：

pip check

2. 显示 pip 的 debug 信息：

pip install -vvv 包名

2. 清除pip缓存：

pip cache purge

2. 显示pip版本：

pip --version

3. 显示pip命令的帮助信息：

pip help

4. 显示特定pip命令的帮助信息：

pip help 命令名