如何从其他目录导入C++20模块并配置Visual Studio导入路径？

和传统#include直接解析头文件源码路径的机制不同，C++20模块的导入过程，识别的是模块接口预先编译生成的二进制接口产物（MSVC为.ifc格式文件，GCC为.gcm格式文件），而非模块源文件本身。如果模块存放在源码目录外，不需要在import语句中硬编码路径，只需要通过编译器参数，告知编译器模块二进制产物的存放搜索范围即可，具体规则如下：

• 提前完成独立模块的编译：把存放在外部目录的模块接口文件，单独编译生成对应的二进制接口产物，不要和当前项目的源文件绑在一起编译
• 配置编译器的模块搜索路径：
  • 针对GCC11，通过编译参数 -fmodules-cache-path=<模块产物所在的外部路径> 指定搜索范围，编译器会自动遍历该路径下的模块缓存文件，匹配对应模块名完成导入
  • 针对MSVC，通过编译参数 /module:search <模块产物所在的外部路径> 指定搜索范围，不需要在import语句中携带任何路径前缀

Visual Studio提供了可视化的配置项替代手动编写命令行参数，配置步骤为：

• 右键对应项目打开属性页，选择需要生效的配置（如Debug/Release）和目标平台
• 定位到 C/C++ > 常规 分类下，找到「模块搜索路径」配置项，把外部模块产物的存放路径添加进去，保存后这些路径会自动转换为对应的/module:search编译参数
• 如果需要把项目内生成的模块统一输出到外部公共目录，可以同步在 C/C++ > 输出文件 分类下的「模块输出路径」中配置公共输出目录，后续其他项目只需把这个公共目录加到模块搜索路径，就可以跨项目复用已编译的模块

常见踩坑：不要把模块源文件的存放目录直接填入模块搜索路径。编译器导入模块时不会主动解析模块源文件，缺少配套的二进制接口产物时，哪怕路径填对了，import语句依然会抛出找不到模块的报错——这是模块和传统头文件包含最容易混淆的区别点。

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