模块接口单元（.ixx/.cppm）须以export module开头且仅一次，导出内容需显式加export；实现单元用module声明归属；标准库用import而非#include；编译需启用C++20及模块开关，构建系统须正确处理.ifc/.pcm依赖。
module声明和定义文件怎么写
模块接口单元（.ixx 或 .cppm）必须用 export module 开头，且只能出现一次；实现单元（.cpp）用 module 声明归属，不加 export。接口单元里想对外暴露的函数、类、模板，得显式加 export 关键字，否则默认不可见。
常见错误：把 export 错写成 exported，或漏掉 export 却以为声明了就能被 import；还有人把 #include 混进模块接口里——不行，模块内不能用传统头文件包含，要用 import 导入其他模块（包括标准库模块）。
-
math.ixx：第一行必须是export module math;，导出函数要写成export int add(int a, int b) { return a + b; } - 非导出内容（比如内部 helper 函数）直接写，不加
export，也不用private修饰 - 标准库要用
import <vector></vector>，不是#include <vector></vector>；MSVC 当前只支持<string></string>、<iostream></iostream>等少数几个标准模块
import语句为什么报错“unknown module”
不是所有编译器都默认启用模块支持，也不是所有源文件都能直接 import。错误通常来自三处：编译器没开模块开关、模块未先构建、路径没配对。
MSVC 要加 /experimental:module 和 /std:c++20；Clang 需 -x c++-system-header 配合模块映射，且当前对模块依赖解析仍较脆弱；GCC 13+ 才开始实验性支持，且不兼容 MSVC 的 .ifc 格式。
立即学习“C++免费学习笔记（深入）”；
- 确保模块接口编译生成 .ifc 文件（MSVC）或 .pcm（Clang），且路径被
/module:reference或-fprebuilt-module-path正确引用 -
import math;报错？检查是否拼错了模块名，或math.ixx根本没参与编译（CMake 里要显式设set_source_files_properties(math.ixx PROPERTIES LANGUAGE CXX)） - 不能在头文件（.h）里写
import，也不能在预编译头（pch）中使用模块
模块和传统头文件能混用吗
能，但边界必须清晰。模块单元里禁止 #include，但普通 .cpp 文件可以同时 import 模块 + #include 头文件；反过来，头文件里绝不能出现 import。
性能上，模块避免了宏污染、重复解析和文本包含开销，但目前跨编译器模块二进制不互通——你用 MSVC 编的 .ifc，Clang 读不了。所以团队协作时，要么统一工具链，要么暂时只对内部组件模块化，对外仍提供头文件封装。
- 已有项目想渐进迁移？先用
module : private;把旧头文件包裹成私有模块单元，再逐步抽离export接口 - 第三方库（如 fmt、spdlog）暂无官方模块支持，只能继续
#include；别试图用import "fmt.h"——语法非法 - 模板定义必须放在模块接口里（不能只声明），否则实例化失败；这点比头文件更严格
为什么 build 很慢，或者 linker 找不到符号
模块编译分两步：先编译接口生成接口文件（.ifc/.pcm），再编译导入单元。如果跳过第一步，或 .ifc 路径没传给后续编译，就会出现 “symbol not defined” 或 “no definition for exported function”。这不是链接问题，是模块依赖没打通。
另外，MSVC 默认不缓存模块编译结果，每次 clean 后重编整个模块图；Clang 的模块映射机制对路径敏感，相对路径写错一格就失效。这些都不是代码逻辑问题，而是构建系统没对齐模块语义。
- CMake 3.28+ 提供
add_module()，但旧版本得手动用target_compile_options加模块参数，并用set_property绑定 .ifc 输出路径 - 检查
import语句所在文件是否用了和模块接口一致的/std:c++20（混用 c++17 会静默失败） - VS2022 中查看模块是否成功加载：打开“输出窗口 → 生成”，搜
Module关键字，看有没有Compiling module interface日志
export module 很容易，让 CI 流水线稳定产出并复用 .ifc 才是多数人卡住的地方。 
