问题：Installing build dependencies卡顿如何解决？

Question

在使用 `pip` 安装 Python 包时，经常遇到“Installing build dependencies”长时间卡顿的问题。该问题通常出现在安装需要编译的依赖包时，如 `wheel` 构建过程卡顿或网络下载缓慢。常见原因包括：网络不稳定导致依赖下载超时、系统缺少必要的编译工具链、或 `pip` 默认使用全局环境构建造成资源竞争。解决方法包括：使用国内镜像源加速下载、安装系统依赖如 `python-dev` 和 `build-essential`、通过 `--no-build-isolation` 禁用隔离构建，或升级 `pip` 至最新版本提升兼容性与性能。

Answer 1

一、问题现象：pip 安装时卡在“Installing build dependencies”

在使用 pip install 安装 Python 包时，尤其是需要从源码构建的包（如 cryptography, numpy, psycopg2 等），常常会遇到长时间卡顿，提示信息为：

Installing build dependencies ... -

这种现象通常发生在构建依赖项下载或编译过程中，影响开发效率和部署流程。

二、常见原因分析

• 网络问题：依赖包的下载源不稳定，尤其是从 PyPI 官方源下载速度慢。
• 缺少系统依赖：如 python-dev, build-essential, gcc, make 等。
• 隔离构建导致资源竞争：默认启用的构建隔离机制会创建临时环境，可能引发资源竞争。
• pip 版本过旧：旧版本 pip 在处理某些依赖时存在性能或兼容性问题。

三、解决方案汇总

解决方案	描述	命令示例
使用国内镜像源	加速依赖下载，减少网络延迟	pip install package_name -i https://pypi.tuna.tsinghua.edu.cn/simple
安装系统依赖	安装编译工具链和开发库	sudo apt-get install python3-dev build-essential
禁用构建隔离	避免创建临时环境造成的资源竞争	pip install package_name --no-build-isolation
升级 pip	提升兼容性与性能	python -m pip install --upgrade pip

四、深入优化建议

在解决基础问题后，还可以进一步优化 pip 安装体验：

1. 缓存机制：使用 --cache-dir 参数设置本地缓存路径，减少重复下载。
2. 预编译 wheel：使用 pip wheel 提前构建好 wheel 包，供离线安装。
3. 虚拟环境隔离：使用 venv 或 conda 管理依赖，避免全局污染。
4. 日志调试：通过 --verbose 查看详细构建日志，便于排查问题。

五、流程图：pip 安装卡顿问题排查流程

graph TD
    A[开始] --> B{是否使用国内源?}
    B -- 否 --> C[更换为国内镜像源]
    B -- 是 --> D{是否安装系统依赖?}
    D -- 否 --> E[安装 python-dev build-essential 等]
    D -- 是 --> F{是否启用构建隔离?}
    F -- 是 --> G[添加 --no-build-isolation]
    F -- 否 --> H{pip 是否为最新版?}
    H -- 否 --> I[升级 pip]
    H -- 是 --> J[尝试缓存或预编译]