将仅头文件库转换为C++模块（GCC 13/14环境）

1. 文件扩展名选择 #

GCC对C++模块文件的扩展名没有强制要求，但行业有通用约定：

• 模块接口单元（带export module声明的文件）推荐用.cppm，这是C++标准草案建议的扩展名，GCC完全支持；
• 若习惯.cxx系列后缀，也可以用.cxxm作为模块接口文件的扩展名；
• 模块实现单元（仅为接口单元提供实现、不带export module的文件）可继续用.cpp或.cxx。
  对于你的仅头文件库，大部分文件会转为模块接口单元，优先选.cppm能让其他开发者快速识别文件类型。

2. Make工具下的模块依赖管理与预编译 #

依赖列表生成工具 #

纯Make环境下，直接用GCC自带参数就能生成模块依赖：

• 编译时添加-MMD -MP参数，GCC会自动生成对应.d后缀的依赖文件，里面包含当前文件依赖的所有模块及头文件；
• 在Makefile中通过include $(wildcard *.d)导入这些依赖文件，Make会自动追踪模块依赖关系，仅预编译需要的模块。

是否需要预编译所有库文件？ #

不是必须，但预编译模块（生成.gcm文件）能大幅提升后续编译速度，尤其适合库文件较多或被频繁引用的场景：

• 若库模块间存在依赖关系，Make会通过依赖文件自动处理编译顺序，只预编译被消费代码依赖的模块；
• 若库规模较小，或开发阶段频繁修改模块代码，也可以选择不预编译，直接让GCC在编译消费代码时实时处理模块接口，代价是每次编译耗时更长。

Makefile示例片段 #

# 预编译模块接口单元为.gcm文件
%.gcm: %.cppm
	g++13 -std=c++20 -fmodules-ts -c $< -o $@

# 编译消费代码，指定模块路径
main: main.cpp foo.gcm bar.gcm
	g++13 -std=c++20 -fmodules-ts -fmodule-path=. -o main main.cpp

# 导入依赖文件
-include *.d

3. 让GCC找到非本地目录的预编译模块 #

有两种常用方式：

• 编译参数指定：在编译命令中添加-fmodule-path=<预编译模块所在目录>，可指定多个路径，Linux/macOS用冒号分隔，Windows用分号分隔，例如-fmodule-path=/usr/local/lib/gcc-modules:/home/my-lib/modules；
• 环境变量配置：设置GCC_MODULE_PATH环境变量，将预编译模块的目录添加进去，GCC会自动搜索该变量中的所有路径。比如Linux下执行export GCC_MODULE_PATH=/usr/local/lib/gcc-modules，或把这条命令加入~/.bashrc实现持久化。

注意：预编译模块的文件名要与模块名对应，比如模块名为my_lib.core，GCC会在指定路径下查找my_lib/core.gcm或my_lib.core.gcm，需保持模块名与文件路径/文件名的一致性。

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