Visual Studio中C++20模块单元测试链接可执行项目报错排查

• 确认模块项目的构建输出配置

  • 把包含my.app.foo模块的可执行项目，构建时的.ifc（BMI文件）和.lib文件统一输出到固定目录，比如项目根目录下的output/modules。
  • 进入模块项目属性：C/C++ -> 输出文件，设置模块输出文件为$(SolutionDir)output/modules/$(TargetName).ifc；再到链接器 -> 常规，设置输出文件为$(SolutionDir)output/modules/$(TargetName).lib。

• 配置测试项目的模块搜索路径

  • 右键测试项目打开属性，找到C/C++ -> 常规，在附加模块包含目录里添加模块.ifc文件所在的目录（比如$(SolutionDir)output/modules）。
  • 划重点：这里不能用附加包含目录，模块有专门的搜索路径配置项。

• 设置测试项目的依赖构建顺序

  • 在解决方案资源管理器里右键测试项目，选项目依赖项，勾选被测试的可执行项目，保证模块项目先于测试项目构建，这样测试项目构建时才有现成的.ifc文件可以读取。

• 检查模块导入语法

  • 测试项目里导入模块要严格用C++20标准语法：import my.app.foo;，注意模块名的大小写——VS对模块名大小写敏感，写错就会找不到。
  • 如果是分区模块，要确认导入的是正确分区，比如import my.app.foo:bar;。

• 清理缓存后重新构建

  • 执行生成 -> 清理解决方案，删掉解决方案目录下的Debug/Release文件夹，先重新构建模块项目，再构建测试项目。
  • 旧的构建缓存经常会导致模块文件找不到，清理后大概率能解决这类问题。

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