pip安装失败（错误代码1）：安装pandas遇编译错误求助

阿华AIGC实验室

2026-5-20

解决pip安装pandas报错（错误代码1 + gcc版本要求）

我之前也踩过这个一模一样的坑！你遇到的问题本质上是编译pandas的C扩展时，编译器版本不满足要求——虽然你装了Visual Studio，但pip可能没正确调用VS的编译工具链，反而用上了系统里旧版本的gcc（或者没配置好VS的环境变量）。下面给你几个亲测有效的解决方案，按优先级来：

1. 直接安装预编译的Wheel包（最省心）

跳过编译步骤，直接用官方打包好的二进制文件：

先把pip升级到最新版本：
```
py -m pip install --upgrade pip wheel
```
强制pip使用二进制包安装pandas（避免本地编译）：
```
py -m pip install pandas --only-binary :all:
```

如果还是不行，可以找和你Python版本、系统位数匹配的pandas wheel文件（比如pandas-2.1.4-cp311-cp311-win_amd64.whl），然后本地安装：

py -m pip install path\to\your\pandas-wheel-file.whl

2. 用conda安装（彻底绕开编译问题）

如果你能安装Anaconda或者Miniconda，这是最稳妥的方式——conda会自动处理所有依赖和编译环境：

conda install pandas

没有conda的话，先装轻量版的Miniconda，再执行上面的命令就行。

3. 修复VS编译环境的调用问题

如果坚持要用pip+VS，得确保pip能正确识别VS的编译器：

打开Visual Studio的开发者命令提示符（比如"x64 Native Tools Command Prompt for VS 2022"），在这个窗口里执行你的pip安装命令：
```
py -m pip install pandas
```

如果还是不行，手动指定VS的编译器环境：

set DISTUTILS_USE_SDK=1
set MSSdk=1
py -m pip install pandas

4. 升级/配置gcc环境（适合愿意折腾的情况）

如果系统里确实有gcc但版本不够：

安装MinGW-w64（选gcc版本>=4的，建议8.1以上），把MinGW的bin目录（比如C:\mingw64\bin）加到系统环境变量PATH的最前面。
然后执行：
```
set CC=gcc
py -m pip install pandas
```

你遇到的报错片段：
Collecting pandas
#ifndef _NPY_NPY_CONFIG_H_
#error config.h should never be included directly, include npy_config.h instead
#endif
EOF
_configtest.c
_configtest.c(6): fatal error C1189: #error: gcc >= 4 required
这就是典型的编译器版本不兼容或者工具链调用错误，上面的方法应该能解决。

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