pipxe安装加速

pip 安装加速完全指南

在 Python 开发中，`pip install` 速度慢是最常见的问题之一。默认的 PyPI 源在国外，国内访问经常出现超时、断流、下载缓慢等情况。本文介绍几种实用、可验证的加速方法，帮助你显著提升安装效率。

一、为什么 pip 安装这么慢

主要原因有几点：

• 源服务器在国外：PyPI 官方源（`pypi.org`）物理距离远，网络延迟高。
• 依赖解析耗时：新版 pip 会花时间解析依赖树，尤其是大型项目。
• 编译安装：某些包没有预编译 wheel，需要现场编译（如 `lxml`、`numpy` 的旧版本）。
• 网络波动：跨境链路不稳定，容易触发重试。

针对这些原因，加速手段也相应分为：换源、优化解析、使用缓存、预编译包等。

二、方法一：配置国内镜像源（最有效）

这是提升速度最直接的方式。国内主流镜像站提供了 PyPI 的完整同步。

常用镜像源

临时使用

单次安装时指定源，适合偶尔使用： bash pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests

永久配置

推荐写入配置文件，一劳永逸。

Linux / macOS 下编辑或创建 `~/.config/pip/pip.conf`（旧版本为 `~/.pip/pip.conf`）： ini [global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn timeout = 120 Windows 下编辑 `%APPDATA%\pip\pip.ini`： ini [global] index-url = https://mirrors.aliyun.com/pypi/simple/ trusted-host = mirrors.aliyun.com timeout = 120 也可以直接用命令写入： bash pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn 查看当前配置是否生效： bash pip config list

配置多个备用源

如果担心单个镜像站偶发故障，可以配置 `extra-index-url`： ini [global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple extra-index-url = https://mirrors.aliyun.com/pypi/simple/ trusted-host = pypi.tuna.tsinghua.edu.cn mirrors.aliyun.com > 注意：添加多个源时，pip 会从所有源查找包，可能略微增加解析时间。一般只配置一个主源即可。

三、方法二：升级 pip 并优化解析

旧版本 pip 的依赖解析器效率较低。建议先升级： bash python -m pip install --upgrade pip 新版 pip 引入了更快的解析逻辑，并在无 wheel 可用时会给出更清晰的提示。

关闭版本检查

pip 默认会检查自身是否有新版本，这会增加一次网络请求。可以关闭： bash pip install --disable-pip-version-check requests 或在配置文件中加入： ini [global] disable-pip-version-check = true

使用 `--no-cache-dir` 的相反策略

很多人误以为加 `--no-cache-dir` 能加速，其实恰恰相反。保留缓存才是加速关键，重复安装时 pip 会直接命中本地缓存，无需重新下载。

四、方法三：利用本地缓存

pip 默认会缓存下载的 wheel 文件。查看缓存目录： bash pip cache dir pip cache list 常用命令： bash pip cache info # 查看缓存占用 pip cache list # 列出已缓存的文件 pip cache purge # 清空缓存 只要不清空，重新安装同名同版本包时几乎瞬间完成。团队环境可以考虑在内网搭建缓存代理（如 devpi、Nexus），进一步减少外网请求。

五、方法四：优先使用预编译包

编译是整个安装过程中最耗时的环节。尽量选择有 wheel 的包： bash pip install --only-binary :all: numpy `--only-binary :all:` 表示只接受二进制包，如果没有可用的 wheel 就会报错，从而避免漫长的编译等待。

对于确实需要编译的场景，可以检查并安装系统级依赖（如 `build-essential`、`python3-dev`），或使用国内提供的预编译 wheel。

六、方法五：批量与并发安装

安装多个包时，一次性列出比逐个安装更快，因为解析和下载可以合并处理： bash pip install requests flask pandas numpy 使用 `requirements.txt` 时，配合镜像源一起生效： bash pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple 如果需要更快的并发下载，可以尝试 `uv`（基于 Rust 的现代安装工具），它在解析和并行下载方面速度优势明显： bash pip install uv uv pip install -r requirements.txt

七、常见问题排查

八、总结建议

对于大多数开发者，配置一个稳定的国内镜像源就能解决 90% 的速度问题。进阶做法包括：升级 pip、保留缓存、优先使用 wheel、以及在团队内搭建私有缓存代理。

推荐的最小配置如下： ini [global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cn timeout = 120 disable-pip-version-check = true 把它写进配置文件后，日常的 `pip install` 体验会有明显改善。