
用 C++20 Modules 替代传统头文件,核心是把声明和实现封装进模块单元,避免宏污染、重复解析和脆弱的包含依赖。它不是简单换语法,而是重构接口组织方式。
模块接口单元(.ixx 或 .cppm)定义公开契约
用 module 声明模块名,export module 标记对外暴露的接口单元。所有想被其他代码使用的类型、函数、模板,必须显式 export:
- 不写 export 的声明/定义只在本模块内可见,天然隔离实现细节
- 可 export inline 函数、constexpr 变量、类及其成员,甚至整个命名空间(export namespace ns { ... })
- 导入其他模块用 import(不是 #include),例如 import std.core; 或 import "my_math";
模块实现单元(.cpp)隐藏细节,无需头文件保护
用 module my_module; 关联到同名接口单元,不加 export。这里写函数定义、静态变量、辅助类等内部逻辑:
- 不用 #pragma once 或 include guard,模块天然单次编译
- 可 import 其他模块(包括自己接口),但不能 export 新符号
- 普通 .cpp 文件也能 import 模块,和传统源文件完全兼容
主程序或翻译单元直接 import,不写 #include
在 main.cpp 或业务源码里,删掉所有相关头文件包含,改用 import:
立即学习“C++免费学习笔记(深入)”;
- import my_module; —— 导入已构建好的模块二进制(如 my_module.ifc)
- import std.io; —— 使用标准库模块(需编译器支持,如 MSVC 已支持部分,GCC 13+、Clang 17+ 逐步完善)
- import 顺序无关,无宏传递副作用,也不触发头文件反复展开
构建需配合编译器模块流程,非一键替换
Modules 不是“改后缀就能跑”,要适配工具链:
- MSVC:用 /interface 编译 .ixx 生成 .ifc;用 /reference 让其他文件引用
- Clang:用 -x c++-system-header 预编译标准模块,--precompile 生成 .pcm,再 --module-file 导入
- CMake 需 3.28+,用 add_module() 和 target_link_libraries(... INTERFACE) 管理依赖
基本上就这些。模块不是银弹,初期要处理标准库支持度、IDE 补全延迟、构建缓存迁移等问题,但长期看能显著提升编译速度和接口可控性。











