Python 3.12下f2py链接静态库失败：undefined symbol错误求助

问题原因 #

Python 3.12的f2py默认使用meson后端，其链接参数处理逻辑与Python 3.11的distutils后端存在差异，导致静态库中的符号无法被正确解析。

解决方案 #

1. 验证静态库符号完整性 #

先确认静态库中确实包含目标符号，排除库本身的问题：

nm libmylibrary.a | grep subroutine1_

若输出中存在subroutine1_符号，说明库文件正常，继续后续操作。

2. 修正f2py链接参数写法 #

meson后端对-l参数的要求更严格，需使用标准库名（去掉lib前缀和.a后缀），而非直接指定.a文件：

f2py -c main.f90 -m inter -L. -lmylibrary

3. 指定Fortran编译器及链接器 #

若仍报错，显式指定使用gfortran作为编译器，确保链接流程适配Fortran库：

f2py -c main.f90 -m inter -L. -lmylibrary --fcompiler=gnu95

或添加参数强制链接gfortran运行时：

f2py -c main.f90 -m inter -L. -lmylibrary --link-libraries gfortran

4. 手动编写meson.build配置文件 #

如果自动生成的meson配置存在问题，可手动编写构建脚本精确控制编译流程：
创建meson.build文件：

project('inter', 'fortran', 'c')

py = import('python')
python = py.find_installation()

# 方式1：直接引用已编译好的静态库
mylib = static_library('mylibrary', files(), objects : 'libmylibrary.a')

# 方式2：直接从源码编译静态库（替代手动编译步骤）
# mylib = static_library('mylibrary',
#   files('subroutine1.f90', 'subroutine2.f90'),
#   install : false
# )

# 构建Python扩展模块
extension = python.extension_module('inter',
  files('main.f90'),
  link_with : mylib,
  install : false
)

执行编译命令：

meson setup build
meson compile -C build

将build/inter.cpython-312-x86_64-linux-gnu.so复制到当前目录，即可正常导入使用。

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