C++20模块是一种替代头文件的标准化代码组织机制,通过export module、module和import实现接口与实现分离,提升编译速度、消除宏污染并增强封装性。

C++20 的模块(Modules)是一种全新的、标准化的代码组织与复用机制,目标是替代传统头文件(#include)带来的编译开销、宏污染、顺序依赖和重复解析等问题。它让接口定义与实现分离更干净,编译更快,依赖关系更明确。
模块的核心概念:interface、implementation 和 import
一个模块由两部分组成:
-
模块接口单元(module interface unit):用
export module声明,定义对外暴露的类型、函数、模板等;相当于传统头文件 +export关键字控制可见性。 -
模块实现单元(module implementation unit):用
module(无 export)声明,包含内部实现细节,不对外导出。 - 其他代码通过
import(而非#include)使用模块,导入后只能访问被export的内容,且不引入宏或预处理副作用。
一个最简可用的模块示例
假设写一个名为 mathutils 的模块,提供加法函数:
// mathutils.ixx(推荐扩展名,表示模块接口)
立即学习“C++免费学习笔记(深入)”;
export module mathutils;
export int add(int a, int b) {
return a + b;
}
// main.cpp
import mathutils; #includeint main() { std::cout << add(2, 3) << '\n'; // 输出 5 }
注意:.ixx 是 MSVC 推荐的模块接口文件扩展名;Clang 和 GCC 常用 .cppm(C++ Module),但具体支持取决于编译器版本与选项。
编译模块需要分步或启用模块感知
目前主流编译器对模块的支持仍需显式启用,且流程不同于传统编译:
-
MSVC(VS 2019 16.8+):默认支持,用
/std:c++20 /experimental:module,并确保.ixx文件被识别为模块接口。 -
Clang 13+(推荐 17+):需
-std=c++20 -fmodules-ts -x c++-system-header等组合,并用-fmodule-file=或自动构建模块依赖图。 -
GCC 11+(实验性):支持有限,需
-std=c++20 -fmodules,但尚未完全稳定,不建议生产环境使用。 - 模块编译通常分两步:先生成模块接口文件的二进制表示(如
mathutils.pcm),再在主程序中引用它。
模块相比头文件的关键优势
-
编译速度显著提升:模块只解析一次,被多次
import也不会重复处理;而头文件每次#include都要重读、重解析、重展开宏。 -
无宏泄漏:
import不触发预处理,模块内定义的宏不会污染导入方的翻译单元。 -
强封装性:只有
export的声明才可见;未导出的辅助函数、静态变量、私有类成员天然隔离。 - 依赖关系清晰可查:模块依赖是显式的、单向的,便于构建系统分析和增量编译优化。










