Cygwin环境编译NumPy 2.2.2失败：fdopen未定义问题求助

问题背景 #

在Cygwin环境下通过pip安装NumPy 2.2.2时出现编译失败，错误提示'fdopen' was not declared in this scope。当前使用的GCC版本信息：

$ gcc --version
gcc (GCC) 12.4.0
Copyright (C) 2022 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

具体编译错误如下：

FAILED: numpy/_core/_multiarray_umath.cpython-312-x86_64-cygwin.dll.p/src_umath_dispatching.cpp.o
c++ -Inumpy/_core/_multiarray_umath.cpython-312-x86_64-cygwin.dll.p -Inumpy/_core -I../numpy/_core -Inumpy/_core/include -I../numpy/_core/include -I../numpy/_core/src/common -I../numpy/_core/src/multiarray -I../numpy/_core/src/npymath -I../numpy/_core/src/umath -I../numpy/_core/src/highway -I/usr/include/python3.12 -I/tmp/pip-install-kpwovpdj/numpy_7571bee3b6aa4eed8b9cd0b0e2263cc5/.mesonpy-_9oiiwhx/meson_cpu -fvisibility=hidden -fvisibility-inlines-hidden -fdiagnostics-color=always -DNDEBUG -Wall -Winvalid-pch -std=c++17 -O3 -msse -msse2 -msse3 -DNPY_HAVE_SSE2 -DNPY_HAVE_SSE -DNPY_HAVE_SSE3 -DNPY_INTERNAL_BUILD -DHAVE_NPY_CONFIG_H -D_FILE_OFFSET_BITS=64 -D_LARGEFILE_SOURCE=1 -D_LARGEFILE64_SOURCE=1 -fno-exceptions -fno-rtti -MD -MQ numpy/_core/_multiarray_umath.cpython-312-x86_64-cygwin.dll.p/src_umath_dispatching.cpp.o -MF numpy/_core/_multiarray_umath.cpython-312-x86_64-cygwin.dll.p/src_umath_dispatching.cpp.o.d -o numpy/_core/_multiarray_umath.cpython-312-x86_64-cygwin.dll.p/src_umath_dispatching.cpp.o -c ../numpy/_core/src/umath/dispatching.cpp
In file included from ../numpy/_core/src/umath/dispatching.cpp:49:
../numpy/_core/include/numpy/npy_3kcompat.h: In function ‘FILE* npy_PyFile_Dup2(PyObject*, char*, off_t*)’:
../numpy/_core/include/numpy/npy_3kcompat.h:119:14: error: ‘fdopen’ was not declared in this scope; did you mean ‘fopen’?
  119 |     handle = fdopen(fd2, mode);
      |              ^~~~~~
      |              fopen

原因分析 #

Cygwin采用POSIX标准，fdopen属于POSIX扩展函数，默认情况下GCC不会启用该函数的声明，必须通过定义特定编译宏（如_POSIX_C_SOURCE或_XOPEN_SOURCE），才能让编译器识别fdopen的声明。

解决方法 #

方法1：添加编译宏后重新安装 #

在执行pip安装前，设置CFLAGS环境变量指定启用POSIX函数的宏：

# 临时设置环境变量
export CFLAGS="-D_POSIX_C_SOURCE=200809L"
# 安装NumPy
pip install numpy==2.2.2

也可以直接在一行命令中完成：

CFLAGS="-D_POSIX_C_SOURCE=200809L" pip install numpy==2.2.2

_POSIX_C_SOURCE=200809L涵盖了大部分现代POSIX函数的声明，足以解决fdopen未声明的问题。

方法2：补全Cygwin开发依赖 #

确保Cygwin环境已安装完整的开发工具链：

• gcc-core、gcc-g++：C/C++编译器
• python3-devel：Python开发头文件和库
• cygwin-devel：Cygwin系统开发依赖

可通过Cygwin的setup.exe工具，在"Select Packages"中搜索并安装上述包，避免因缺少头文件导致编译问题。

方法3：尝试安装预编译二进制包 #

如果Cygwin的pip源提供了对应版本的预编译NumPy包，可直接安装二进制版本跳过编译：

pip install numpy==2.2.2 --only-binary :all:

注意：若没有对应版本的二进制包，该命令会失败，需回到方法1或2解决编译问题。

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