如何在meson.build子项目中确保各子项目使用自身的config.h？

我正在用meson.build开发一个C语言库，通过wrap-files和fallback-arguments将多个依赖项作为子项目集成。为了实现统一构建步骤（比如给所有模块添加-fsanitize=address编译链接标志或自定义编译/链接标志），我使用了-Dwrap_mode=forcefallback参数。

但其中一个依赖项harfbuzz无法通过该参数构建，核心问题是存在多个config.h文件。配置完成后，构建目录中的config.h分布如下：

$ find . -name config.h
./config.h
./subprojects/pixman/pixman/config.h
./subprojects/glib-2.74.1/config.h
./subprojects/gperf/config.h
./subprojects/pcre2-10.40/config.h
./subprojects/cairo/config.h

pixman库会检查头文件包含顺序，由于实际引入的config.h并非pixman专属的文件，触发了#error报错，导致无法用-Dwrap_mode=forcefallback构建harfbuzz。尽管libpixman提供了meson构建文件，但它自身未使用meson子项目机制（自带glib-2依赖），因此该问题在其单独构建时未暴露。

现咨询meson构建最佳实践：如何确保每个子项目始终使用自身的config.h？或是在上游项目中创建一个适配子项目结构的统一config.h来替代所有子项目的config.h更合适？

绝对不推荐：用统一config.h替代子项目的config.h #

每个子项目的config.h是针对自身编译环境生成的，包含各自的特性检测结果、编译宏定义，统一替换会导致子项目依赖的宏定义错误，引发更多编译问题，完全不可行。

可行的解决方法： #

1. 调整子项目头文件搜索优先级
   对于pixman这类子项目，修改其meson.build文件，确保自身的头文件目录被设置为优先搜索路径，避免根目录的config.h被误包含。比如在pixman的meson.build中添加：

   # 确保作为子项目时优先加载本地config.h
   pixman_local_inc = include_directories('pixman', override: true)
   

   这样编译pixman代码时，会先搜索pixman目录下的config.h，而非根目录的文件。

2. 在根项目中为子项目单独配置编译上下文
   如果无法修改上游子项目的meson.build，可以在根项目的meson.build中，通过subproject()的default_options参数，为特定子项目单独添加头文件搜索路径：

   pixman_sub = subproject('pixman', default_options: [
     'c_args=-I@0@'.format(meson.current_source_dir() / 'subprojects' / 'pixman' / 'pixman'),
     'cpp_args=-I@0@'.format(meson.current_source_dir() / 'subprojects' / 'pixman' / 'pixman'),
   ])
   

   强制pixman编译时优先搜索自身的pixman目录，确保找到正确的config.h。

3. 避免根目录config.h全局可见
   如果根项目的config.h不需要被所有子项目访问，不要将根目录的include路径添加到全局的include_directories中，仅在根项目的目标中单独指定：

   my_library = library('my_lib',
     sources: my_sources,
     include_directories: include_directories('.'), # 仅根项目目标使用该路径
     ...
   )
   

   这样子项目不会继承根目录的include路径，也就不会误包含根的config.h。

4. 上游修复（长期最优方案）
   给pixman上游提交PR，修改其meson.build文件，适配子项目集成场景，确保无论单独构建还是作为子项目，都能正确加载自身的config.h。这类修改通常是通用的，上游社区大概率会接受。

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