模块文件需以module;为首行非注释语句，接口单元用export module声明，导出内容须显式export，私有实现放module : private;或实现单元；混用import与#include易致odr冲突，应隔离；编译变慢主因是bmi缓存未命中或模块粒度过细；msvc支持最全，clang需手动预编译标准头，gcc 13仅实验性支持。
模块文件怎么写才不被编译器拒之门外
模块不是头文件的简单改名，module 和 export 关键字的位置、顺序、作用域都直接影响能否通过解析。常见错误是把 #include 放在 module; 前面，或者在模块接口单元里漏掉 export module —— 这会导致编译器报 error: expected 'module' after 'export' 或直接当普通翻译单元处理。
实操建议：
立即学习“C++免费学习笔记（深入）”；
-
module;必须是模块接口单元（.ixx 或 .cppm）的第一条非注释、非空行 - 导出声明必须用
export显式标记，比如export void foo();，函数定义本身不自动导出 - 私有实现部分（如内联细节、辅助类）应放在
module : private;分段或单独的模块实现单元中，避免污染接口 - 跨平台时注意：MSVC 默认用
.ixx，Clang 推荐.cppm，GCC 13+ 才初步支持，且需显式开启-fmodules-ts（已过时）或-std=c++20 -fmodules
import 和 #include 混用会出什么问题
不能假设 import 是“高级 #include”。一旦某个翻译单元用了 import，它就进入了模块感知模式，此时再用 #include 引入传统头文件，可能触发宏污染、ODR 冲突或预处理器状态错乱。典型现象是 std::vector 编译失败，或出现 redefinition of 'class X'。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 一个 TU（.cpp 文件）里要么全用
import（推荐），要么全用#include；混用必须加隔离层，比如把旧头文件封装进一个仅含#include的模块实现单元里 -
import <vector></vector>不等于#include <vector></vector>：前者导入的是标准库提供的模块接口（需编译器支持），后者仍是文本包含；目前仅 MSVC 对标准库模块支持较完整，Clang/GCC 多数仍走头文件 fallback - 第三方库几乎都不提供模块接口，
import "boost/optional.hpp"会失败，得用module boost_optional { requires "boost/optional.hpp"; }封装（Clang）或放弃
为什么开了模块反而编译更慢了
模块加速的前提是模块接口被复用且缓存命中。如果每次构建都重新生成模块接口单元（BMI / PCM），或模块依赖图太浅（每个模块只被用一次），那磁盘 I/O 和 BMI 生成开销反而盖过收益。常见于 CI 环境清缓存构建，或模块粒度太细（比如一个函数一个模块）。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确保模块接口单元（.ixx）稳定：避免在其中
#include本地头文件或使用易变宏，否则每次修改都会导致所有依赖它的模块重编 - 用
-fmodules-cache-path（Clang）或/module:cache（MSVC）指定持久化缓存路径，并纳入构建脚本管理 - 模块命名空间宜粗不宜细：按逻辑层（
core、network、serialization）而非单个类划分，减少 import 数量和 BMI 文件总数 - 检查 BMI 文件大小：若单个
core.pcm超过 50MB，说明导出内容过多，应拆分私有实现或用export import代理子模块
Clang / MSVC / GCC 在模块支持上到底差在哪
不是“支不支持”，而是“支持到哪一层”。MSVC 最激进但生态绑定强；Clang 最规范但默认关模块；GCC 最保守，C++20 模块至今未正式启用。实际项目中，选型直接决定你能写什么、要不要降级。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- MSVC（VS 2019 16.8+）：支持
import <vector></vector>、模块分区、module : private;，但要求所有源文件统一用.ixx，且 CMake 需set_property(SOURCE x.ixx PROPERTY LANGUAGE CXX) - Clang 15+：需显式
-x c++-system-header预编译标准头为模块，且import "foo.h"仅在启用 header unit 时有效（非标准，勿依赖） - GCC 13：仅实验性支持，必须加
-fmodules-ts（已废弃）或-fmodules+-std=c++20，且不支持 import 标准库，BMI 格式不稳定，CI 中慎用 - 跨编译器项目：用
#ifdef __cpp_modules包裹import，fallback 到#include，并接受模块仅在主力工具链生效
模块真正省时间的地方不在单次编译，而在增量构建——但前提是你的模块边界足够稳定、缓存不被每天清空、团队不用 GCC 修 bug。否则，它只是个漂亮的语法糖。
