Visual Studio使用C++模块时出现Compiler error C2237错误求助

错误触发原因 #

error C2237: multiple module declaration 是MSVC编译器检测到单个编译单元内存在多次模块声明触发的错误，你的场景下常见触发点如下：

• 模块文件同时保留了传统头文件的#pragma once防护指令和export module模块声明，MSVC的C++模块实现内置了重复引入防护，额外的#pragma once可能导致编译器判定模块声明重复
• 该文件既被其他代码以#include的方式作为头文件引入，又被作为独立模块单元参与编译，模块声明被重复解析
• 项目配置开启了强制包含，引入的其他文件中也存在模块相关声明，和当前文件的模块声明冲突
• 未修改模块文件扩展名，VS默认按头文件逻辑扫描的同时又将其作为编译单元编译，导致两次解析模块声明

解决方案 #

优先级从高到低依次尝试：

• 移除模块文件中的#pragma once指令，修改后代码如下：

export module FieldData;

namespace Serializer
{
    class FieldData
    {
    public:
        bool nvConverted{ false };
    };
}

• 优先将模块接口文件的扩展名改为.ixx，这是MSVC默认识别的C模块接口单元扩展名，无需手动修改项类型即可被正确编译；如果不想修改扩展名，可在对应文件的属性页中，选择「C/C -> 所有选项 -> 编译为」，设置为编译为C++模块代码(/interface)
• 检查项目属性「C/C++ -> 高级 -> 强制包含文件」配置，确认没有引入包含模块声明的其他文件
• 确认所有其他代码都以import FieldData;的方式引入该模块，没有任何文件使用#include引入该模块文件
• 清理项目编译缓存：点击VS菜单栏「生成 -> 清理解决方案」，删除项目根目录下的临时生成文件夹（x64/x86、Debug/Release等）后重新生成即可

内容的提问来源于stack exchange，提问作者laurisvr