Autotools项目如何精简冗长的Makefile.am构建配置

1. 配置中是否必须逐个枚举引入所有.c源文件？ #

是，原生Automake的设计规则要求显式列出所有参与编译的源文件，没有内置自动递归扫描目录收集源文件的能力。
这个设计是刻意为之：一是保证构建可复现，避免目录下的临时文件、测试用例、废弃代码被意外纳入编译流程；二是确保make dist生成的官方发布包能准确包含所有必要源码，既不会漏文件也不会混入无关内容。

2. 为什么vendor/my_vendor/host/*/**这类通配符写法无法正常生效？ #

核心原因有两点：

• Automake在解析Makefile.am阶段不会主动展开shell通配符，会把通配符字符串原样写入生成的Makefile，留到make执行阶段才处理，而Automake本身的构建规则（比如依赖推导、发布包文件列表）是在运行automake时就根据显式列出的文件固定生成的，通配符匹配到的文件不会被纳入这些规则里。
• 就算到make执行阶段，**这类递归通配符也不是所有make实现都支持（低版本GNU make、BSD make默认都不识别该语法）；同时通配符匹配的结果不会触发构建系统重新生成，新增、删除源文件时构建系统无法感知变动，会出现新文件未参与编译、已删除文件被错误引用的问题，make dist打包时也会漏包含通配符匹配到的源码，直接导致发布包残缺。

3. 可通过哪些方法压缩、精简makefile.am的配置内容？ #

以下是经过生产验证的可行方案，按推荐优先级排序：

• 采用递归构建按模块拆分配置
  不要把所有源码配置堆在顶层Makefile.am，利用Automake的递归构建能力，按功能模块/第三方代码拆分独立子目录，每个子目录维护自己的Makefile.am，将子模块编译为不安装的便捷静态库（noinst_LTLIBRARIES），顶层主程序只需要链接这些子模块库即可。
  比如vendor目录下单独写Makefile.am把所有厂商代码编译成libmyvendor.la，自己代码的utilities、comms、config_parsing目录也分别编译成对应便捷库，顶层不需要再列几十上百个vendor源文件和对应的头文件搜索路径，配置量会直接减少70%以上。
  示例vendor目录的Makefile.am片段：

  noinst_LTLIBRARIES = libmyvendor.la
  libmyvendor_la_SOURCES = \
  production/source/lib/FFT/FFT.c \
  production/source/PROD_lib.c \
  host/source/HLB_helper.c
  # 其余厂商源码列在此处即可
  libmyvendor_la_CPPFLAGS = \
  -I$(srcdir)/host/include \
  -I$(srcdir)/host/source/lib/comm_mgr/inc
  # 其余厂商代码需要的头文件路径列在此处即可
  

  顶层只需要在SUBDIRS中列出所有子模块目录，在MAIN_Application_LDADD中加入各个子模块的.la库文件即可。

• 拆分公共变量减少重复书写
  对长路径、同模块源文件可以提前定义公共变量复用，避免反复写重复的长字符串。
  示例：

  # 定义公共路径前缀
  VENDOR_ROOT = $(srcdir)/vendor/my_vendor
  # 按模块拆分源文件列表
  UTIL_SRCS = \
  src/utilities/time_conversions.c \
  src/utilities/ring_buffer.c \
  src/utilities/logger.c \
  src/utilities/string_operations.c
  
  VENDOR_SRCS = \
  $(VENDOR_ROOT)/production/source/lib/FFT/FFT.c \
  $(VENDOR_ROOT)/production/source/PROD_lib.c
  # 其余源文件按模块归类
  
  AM_CPPFLAGS = \
  -I$(srcdir)/include \
  -I$(VENDOR_ROOT)/host/include \
  -I$(VENDOR_ROOT)/public/common
  # 其余头文件路径用公共前缀拼接
  
  MAIN_Application_SOURCES = src/main.cpp $(UTIL_SRCS) $(COMM_SRCS) $(CONFIG_SRCS) $(VENDOR_SRCS)
  

• 收敛头文件搜索路径
  自有代码不需要把每个include下的子目录都加到-I参数中，只需要把最上层的include目录加入搜索路径，代码中引用头文件时带上子目录前缀即可，比如原来写#include "logger.h"对应-I$(srcdir)/include/utilities，可以改成只加-I$(srcdir)/include，代码中写#include "utilities/logger.h"，直接砍掉一批重复的头文件路径配置。

• 自动生成源文件列表片段
  如果确实不想手动维护长源文件列表，可以在autogen.sh脚本中、运行automake之前，加一段简单的扫描逻辑，遍历指定目录生成独立的makefile片段文件（比如vendor_srcs.mk），片段里提前定义好对应模块的源文件、头文件路径变量，然后在主Makefile.am中用include vendor_srcs.mk引入即可。注意扫描动作必须在automake执行前完成，不能放到make执行阶段，避免automake解析时拿不到变量值报错。这种方式比直接在Makefile.am中写通配符可靠，每次重新生成构建系统时都会同步更新文件列表，适配Jenkins全量构建的流程。

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