执行pip install -r requirements.txt出现OSError及依赖安装失败如何解决

步骤1：修复已损坏的numpy安装 #

本地环境中已安装的numpy 1.21.2版本元数据文件丢失，导致无法正常执行卸载、升级、依赖校验等操作，直接执行以下命令强制修复：

pip install --force-reinstall --no-deps numpy==1.21.2

--no-deps参数用于避免连带更新numpy的关联依赖，防止引发额外的版本冲突。

步骤2：解决bottleneck包编译失败问题 #

你使用的是Anaconda环境，优先选择更简单的预编译包安装方案，无需安装额外的编译工具：

conda install bottleneck

如果不愿意使用conda安装，也可以安装Microsoft Visual C++ 14.0及以上版本的编译工具，选择「桌面开发使用C++」工作负载安装完成后重启终端即可。

步骤3：正常安装项目依赖 #

完成前两步操作后，重新执行原依赖安装命令即可：

pip install -r requirements.txt

额外注意事项 #

• 不要随意使用--ignore-installed参数执行pip安装，该参数会跳过现有依赖校验，极易破坏本地环境的依赖结构
• 如果后续安装过程中还有其他二进制包编译报错，优先用conda install [包名]安装预编译版本，可避免大部分编译环境问题

内容的提问来源于stack exchange，提问作者ketan gangal