Windows 下 MinGW 启用 C++20 modules 需使用 GCC 11 或更高版本，编译时添加 -fmodules 和 -std=c++20 参数，但该功能在 MinGW 环境下仍处于实验阶段，生产环境建议谨慎评估。

命令速用版

直接使用 g++ 编译时，需在命令行显式开启模块支持并指定 C++ 标准，以下命令适用于单文件模块测试：

g++ -std=c++20 -fmodules -fmodules-ts main.cpp -o main.exe

若使用 CMake，需在 CMakeLists.txt 中设置 CXX_STANDARD 并尝试启用实验性标志，但 CMake 对 GCC modules 的原生支持仍在完善中。

为什么会这样

GCC 对 C++20 modules 的实现尚未完全稳定，Windows 下的 MinGW 工具链存在路径处理和二进制接口兼容性问题。

C++20 modules 旨在替代头文件包含机制，但 GCC 实现相比 MSVC 和 Clang 起步较晚。MinGW 作为 Windows 下的 GCC 移植版，依赖底层 GCC 版本特性。早期 GCC 版本仅支持 Modules TS（Technical Specification），C++20 标准支持在 GCC 11 引入，后续版本逐步修复链接器和文件名映射问题。Windows 文件系统大小写不敏感和路径分隔符差异也可能导致模块查找失败。

分步处理

按顺序检查环境、编写代码、配置编译参数，每一步完成后确认无报错再进行下一步。

步骤 1：确认编译器版本

在命令行输入 g++ `--version`，确认版本号不低于 11。若版本过低，需更新 MinGW-w64 工具链，推荐使用 WinLibs 或 MSYS2 提供的最新构建版。

步骤 2：编写模块接口文件

创建模块声明文件，例如 math.ixx 或 math.cpp，使用 export module 语法。注意文件扩展名不影响功能，但需保持一致性。

export module math;
export int add(int a, int b) { return a + b; }

步骤 3：编写消费代码

在主文件中 import 模块，避免混合使用 #include 处理同一接口。

import math;
int main() { return add(1, 2); }

步骤 4：执行编译命令

使用 -fmodules 标志编译。若遇到链接错误，尝试添加 -fmodules-ts 兼容旧实现，或检查生成的 .o 文件是否存在。

怎么验证是否生效

编译过程无 error 报错且生成可执行文件，运行时输出预期结果即视为基本生效。

检查命令行输出是否有 module related error 警告。观察编译目录下是否生成 .gcm 或类似的模块缓存文件（GCC 实现细节可能不同）。若程序运行崩溃或链接器报告 undefined reference 到模块符号，说明模块未正确链接。

常见坑

以下场景容易导致编译失败或运行时错误，操作前需评估风险。

• 版本不匹配：GCC 11 以下版本不支持 -fmodules，强制使用会报 unknown command line option 错误。
• 路径空格问题：项目路径包含空格或中文字符时，GCC 模块缓存可能读取失败，建议全英文路径。
• CMake 支持不足：CMake 3.28 之前对 C++20 modules 支持有限，可能需要手动添加编译选项而非使用标准 target_compile_features。
• 混合编译风险：同一项目中混用 modules 和传统头文件声明同一符号可能导致 ODR 违规或链接冲突。

常见问题

MinGW 哪个版本稳定支持 C++20 modules？

GCC 13 及以上版本支持度较好，GCC 11-12 存在已知缺陷。

公开资料中没有看到可靠的量化数据表明具体哪个小版本完全稳定，建议直接使用能获取的最新 GCC 版本进行测试。

为什么加了 -fmodules 还是报错？

可能是编译器版本过低或模块文件未正确编译。

先确认 g++ `--version` 输出，再检查是否所有模块源文件都参与了编译流程，单独编译接口文件有时是必要的。

MinGW 和 MSVC 的 modules 兼容吗？

不兼容，不同编译器的模块二进制格式不同。

不能在 MinGW 编译的程序中直接 import MSVC 生成的模块接口，跨编译器复用模块目前不可行。

参考来源

• GCC Online Documentation, C++ Modules, https://gcc.gnu.org/onlinedocs/gcc/C_002b_002b-Modules.html
• MinGW-w64 Official Website, https://www.mingw-w64.org/
• CMake Documentation, C++ Modules, https://cmake.org/cmake/help/latest/manual/cmake-cxxmodules.7.html