NumPy C-API：支持numpy.float16时出现未定义引用错误

问题场景 #

在Windows 10环境下，使用GCC 13.2（MSYS2）或MSVC 19.38构建NumPy ufunc示例时，尝试支持numpy.float16类型，链接器报错提示npy_half_to_float和npy_float_to_half存在未定义引用，尽管已正确包含numpy/halffloat.h头文件。

错误原因 #

npy_half_to_float和npy_float_to_half并非头文件内的静态内联函数，而是NumPy核心库npymath提供的外部符号。构建脚本未正确链接该库，导致链接器无法找到这两个函数的实现。

解决方向 #

1. 定位NumPy的npymath库 #

找到NumPy安装目录下的核心库文件夹：

• MSYS2环境：通常在/mingw64/lib/pythonX.Y/site-packages/numpy/core/lib（X.Y为Python版本），包含libnpymath.a静态库
• MSVC环境：通常在Lib\site-packages\numpy\core\lib，包含npymath.lib（区分release/debug版本）

2. 修改构建脚本（meson.build） #

在构建目标中添加对npymath库的链接：

# 获取NumPy依赖
numpy_dep = dependency('numpy', version: '>=1.10')

# 定位npymath库路径
npymath_lib_dir = join_paths(numpy_dep.get_pkgconfig_variable('prefix'), 'numpy', 'core', 'lib')
# 查找并链接npymath库
npymath_lib = cc.find_library('npymath', dirs: npymath_lib_dir)

# 构建可执行文件，同时依赖NumPy和npymath
executable(
  'npufunc',
  'npufunc.c',
  dependencies: [numpy_dep],
  link_with: [npymath_lib]
)

或者直接通过pkgconfig获取完整链接选项，部分版本的NumPy的.pc文件已包含npymath的链接信息：

numpy_pc = import('pkgconfig').load('numpy')
executable('npufunc', 'npufunc.c', dependencies: [numpy_pc])

3. 确认编译宏定义 #

编译时需确保启用正确的NumPy API版本，避免废弃API影响函数解析，在编译选项中添加：

-DNPY_NO_DEPRECATED_API=NPY_1_10_API_VERSION

（版本号可根据使用的NumPy版本调整，至少1.10+）

4. MSVC环境额外检查 #

• 确保链接的npymath.lib版本（release/debug）与当前构建模式匹配
• 将npymath所在库路径添加到链接器的搜索路径中

5. 验证NumPy版本 #

确认使用的NumPy版本≥1.10，更早版本可能未对外暴露这两个半精度转换函数。

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