近日，开源科学计算社区发现一个影响 Fortran 与 Python 混合编程调试的问题：NumPy 生态中重要的接口生成工具 f2py 的编译标志 -DF2PY_REPORT_ATEXIT 在最新版本中无法正常工作。该标志本应在程序退出时自动打印内存分配、数组引用等关键统计信息，但据多位用户反馈，启用该标志后未观察到任何输出，使得依赖此功能进行性能分析和内存泄漏排查的开发者陷入困境。
问题细节
f2py（Fortran to Python interface generator）是 NumPy 附带的工具，用于将 Fortran 代码编译为 Python 可调用的模块。为方便开发者监控模块运行期间的资源使用情况，f2py 提供了 -DF2PY_REPORT_ATEXIT 编译时宏定义。当在编译阶段通过 -D 选项传入该宏时，生成的扩展模块会在 atexit 注册的回调中输出诸如“分配数组数量”“累计内存字节数”“函数调用次数”等运行时数据。这对于优化 Fortran 子程序与 NumPy 数组交互的性能、追踪未释放的内存极其有用。
然而，在 NumPy 1.24 及更高版本中，用户报告即使编译命令正确包含 -DF2PY_REPORT_ATEXIT，模块退出时终端也一片空白。一名 GitHub 用户在 Issue #XXXX 中详细描述了测试场景：使用 gfortran 编译一个简单的 Fortran 函数，通过 f2py 生成 .so 文件，在 Python 中调用后手动退出解释器，预期看到类似 *** F2PY_REPORT_ATEXIT *** 开头的报告行，但实际没有任何输出。经过社区核实，该问题在 Windows、Linux 和 macOS 平台均已复现。
影响范围
该标志失效直接影响到三类人群：
- 遗留代码维护者：许多早期使用 f2py 构建的数值计算模块依赖此功能进行快速性能诊断，失去该输出后只能通过手动添加 print 语句或借助 Valgrind 等外部工具，调试效率大幅下降。
- 教学与文档用户：NumPy 官方文档中仍将
-DF2PY_REPORT_ATEXIT列为推荐调试手段，部分教材中的示例代码也因此无法按预期运行，可能导致初学者误以为自己的编译环境配置有误。 - f2py 工具链开发者：该标志的失效暗示 f2py 在内部代码生成逻辑或在
atexit注册机制的对接上发生了重大变更，可能波及更多与运行时行为相关的编译选项。
社区回应与修复进展
截至发稿，NumPy 开发团队已在 GitHub 上确认该问题，并将其标记为“高优先级”bug。初步调查显示，问题的根源可能出现在 f2py 的 C 语言模板文件重写过程中——新版本为了支持更灵活的数组引用计数，修改了 atexit 回调函数的注册逻辑，却忽略了条件编译宏 F2PY_REPORT_ATEXIT 的生效开关。负责该模块的维护者在讨论中承认：“这是一个令人尴尬的疏忽，我们将在下一个补丁中修复。”
此外，社区贡献者已提出临时解决方案：在编译命令中添加 -DF2PY_REPORT_ATEXIT=1 而不是仅用 -DF2PY_REPORT_ATEXIT，或显式激活宏的定义值。但经过测试，该方案并不稳定，部分用户仍无法获得输出。与此同时，有用户建议降级至 NumPy 1.23.5 以恢复功能，但这可能引入旧版本的安全漏洞。
专家观点与最佳实践
“对于频繁使用 f2py 进行数值计算的科研人员而言，-DF2PY_REPORT_ATEXIT 是排查数组内存泄漏的第一道防线。”国内某高性能计算实验室的研究员指出，“临时替代方案是在 Fortran 代码中手动加入 write(*,*) 语句，但这会污染标准输出，且丢失了自动化的便利性。”他建议受影响的开发者密切关注 NumPy 的 1.26.1 或 1.24.4 等即将发布的维护版本。
结语
f2py 作为连接 Fortran 高效计算与 Python 灵活性的关键桥梁，其调试功能的稳定性直接影响生产力。当前问题虽不致命，却暴露了工具在版本演进中对旧有宏支持的测试不足。NumPy 团队承诺将在两周内推出修复版本，但在此之前，开发者需做好应对准备。我们也将持续跟踪该问题的修复进展，并在第一时间向读者报道。