在多个文件中导入C++23标准库模块时出现多重定义错误

是不是预期行为？ #

这不是预期行为，属于Visual Studio 17.8.0 Preview 1.0版本中C模块实现的已知bug。按照C23标准，完全允许在多个文件中重复导入标准库模块或头文件单元，不会引发符号重复定义的链接错误。

解决办法 #

有两种可行的处理方式：

• 优先升级IDE版本：微软在17.8 Preview 2及后续版本中已经修复了这个符号重复定义的问题，升级到更新的预览版或正式版就能直接解决。
• 临时规避方案（无法升级时）：
  1. 调整项目编译模式：打开项目属性，找到「C/C++」→「所有选项」→「模块编译模式」，设置为「作为单个翻译单元编译（整个程序编译）」。
  2. 用公共模块封装标准库导入：创建一个中间模块统一导入标准库，其他文件导入这个模块即可避免重复导入的问题：

     // std_wrapper.ixx
     export module std_wrapper;
     import std;
     // 按需导出需要的符号，比如：
     export using std::print;
     

     然后修改你的代码：

     // test.ixx
     export module test;
     import std_wrapper;
     
     export void do_test() {
         std::print("test\n");
     }
     
     // main.cpp
     import std_wrapper;
     import test;
     
     int main() {
         std::print("Hello Modules\n");
         do_test();
     }
     

补充说明 #

你替换成import <print>;仍报错的情况，验证了这是VS模块编译链的底层问题——头文件单元的处理逻辑和标准库模块共用了存在bug的编译环节，所以两种导入方式都会触发相同的链接错误。

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