如何将多目录Modern CMake结构迁移至Autotools构建体系？

完全可行，Autotools原生支持这种多目录分层构建的结构，只要对应配置Makefile.am和configure.ac，就能复刻你原有的Modern CMake目录逻辑，同时保留源码结构。下面是具体实现步骤，重点解决你遇到的头文件找不到问题：

1. 根目录核心文件配置 #

configure.ac #

初始化项目并声明子目录，按依赖顺序排列（被依赖的子目录放前面）：

AC_INIT([your-project-name], [1.0.0], [your-contact@example.com])
AM_INIT_AUTOMAKE([-Wall -Werror foreign])
AC_PROG_CXX
# 列出所有需要构建的子目录，顺序按依赖优先级来
AC_CONFIG_SUBDIRS([src/utils src/core src/moduleA])
AC_OUTPUT([Makefile])

根目录Makefile.am #

定义主可执行文件、链接依赖库，并显式添加所有子目录的头文件搜索路径：

# 声明要生成的可执行文件
bin_PROGRAMS = main_app
# 可执行文件的源文件
main_app_SOURCES = src/main.cpp
# 链接子目录编译出的库（后缀.la是libtool生成的库文件）
main_app_LDADD = src/core/libcore.la src/utils/libutils.la src/moduleA/libmoduleA.la
# 关键：添加所有子目录的头文件搜索路径，解决编译时找不到深层头文件的问题
AM_CPPFLAGS = -Isrc/utils -Isrc/core -Isrc/moduleA

2. 子目录Makefile.am配置 #

每个子目录（比如src/core）下的Makefile.am，定义本目录的库目标和头文件：

# 生成仅内部使用的库（noinst_表示不安装到系统路径）
noinst_LTLIBRARIES = libcore.la
# 库的源文件列表
libcore_la_SOURCES = core_logic.cpp data_processor.cpp
# 声明本目录的头文件，Autotools会自动处理这些文件的依赖
noinst_HEADERS = core_logic.h data_processor.h

# 如果该子目录还有嵌套子目录，比如src/core/sub，要在这里声明
# SUBDIRS = sub

• 如果需要把库或头文件安装到系统路径，把noinst_LTLIBRARIES改成lib_LTLIBRARIES，noinst_HEADERS改成include_HEADERS并指定安装路径。

3. 解决头文件找不到的关键细节 #

• 显式指定搜索路径：通过根目录或子目录的AM_CPPFLAGS参数，把所有依赖子目录的路径用-I前缀添加进去，编译器就能自动找到深层目录的头文件。
• 子目录顺序正确：configure.ac里的AC_CONFIG_SUBDIRS必须按依赖顺序排列，比如moduleA依赖core，那core要放在moduleA前面，确保先编译依赖库。
• 头文件声明完整：子目录里用noinst_HEADERS列出所有头文件，Autotools会自动维护这些文件的编译依赖关系，避免遗漏。

4. 标准构建流程 #

配置完所有文件后，执行以下命令完成构建：

# 生成configure脚本及相关辅助文件
autoreconf -vfi
# 配置项目，可指定安装路径
./configure --prefix=/opt/your-app
# 编译项目
make
# 安装（可选）
make install

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