aclocal异常行为：生成的aclocal.m4内容交替缺失模块

问题背景 #

你在使用autoconf的项目中新增Python模块版本检查，引入ax_python_module_version.m4模块，configure.ac配置如下：

AC_CONFIG_AUX_DIR([config])
AC_CONFIG_MACRO_DIR([config/m4])
m4_include([config/aclocal.m4])

config/m4目录包含以下文件：

ax_check_docbook_xslt.m4
ax_prog_xsltproc.m4
ax_python_module.m4
ax_python_module_version.m4

执行aclocal --output config/aclocal.m4时出现异常：第一次生成的文件仅包含新模块引用，第二次则包含除新模块外的所有其他模块，后续每次执行在两种状态间切换；手动添加新模块后执行能保持完整内容，但担心配置存在问题。

排查步骤 #

• 移除configure.ac中的m4_include([config/aclocal.m4])
  这是核心问题：aclocal的作用是收集configure.ac中用到的宏并生成aclocal.m4，而你把生成的aclocal.m4又包含回configure.ac，会造成循环依赖。第一次执行时aclocal.m4为空，只收集新模块；第二次执行时configure.ac包含了第一次的aclocal.m4，认为新模块宏已存在，转而收集其他宏，如此反复交替。autoconf体系不需要手动include生成的aclocal.m4，移除这行即可解决交替问题。

• 确认configure.ac中宏调用完整
  检查configure.ac是否真的调用了所有需要的宏：比如AX_PYTHON_MODULE_VERSION、AX_CHECK_DOCBOOK_XSLT、AX_PROG_XSLTPROC、AX_PYTHON_MODULE。如果某个宏没被调用，aclocal不会将对应的m4文件内容加入aclocal.m4，可能导致部分模块缺失。

• 检查m4文件的宏定义规范
  确认ax_python_module_version.m4的宏定义符合标准：是否以AC_DEFUN或AC_DEFUN_ONCE开头，有没有语法错误（比如括号不匹配、未闭合引用）。这类错误会导致aclocal无法正确识别宏，从而跳过收集。

• 清理缓存后重新测试
  执行以下命令清理所有自动生成的文件，从干净状态重新生成：

  rm -f config/aclocal.m4 config/configure config.status autom4te.cache/*
  aclocal --output config/aclocal.m4
  autoconf
  

  缓存文件可能干扰生成逻辑，清理后能排除这类问题。

• 验证aclocal版本兼容性
  执行aclocal --version查看版本，不同版本的aclocal在宏收集逻辑上可能存在差异。如果是旧版本，可尝试升级到稳定版（比如2.69或2.71）测试，确认是否存在已知版本bug。

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