此开关指示编译器将 #include 视为 import,用于已内置到标头单元 (.ifc) 文件并在命令行中通过 /headerUnit 指定的头文件。
与 /scanDependencies 或 /sourceDependencies-directives 一起使用时,编译器会在生成的依赖项文件中将那些既包含在源文件中又在 header-units.json 文件中具有相应条目的标头作为导入的标头单元列出。 此依赖项信息由生成系统用来生成已编译的标头单元 .ifc 文件。 生成标头单元后,编译器会将其视为 import 而不是 #include。
只有在指定了 /translateInclude 时,才会查阅 header-units.json 文件。 有关 header-units.json 文件的格式和用途的详细信息,请参阅 header-units.json。
如果 header-units.json 文件中未列出 #include 文件,则会将其视为普通的 #include。
有关如何使用此开关的示例,请参阅演练:在 Microsoft Visual C++ 中生成和导入标头单元。
语法
/translateInclude
备注
/translateInclude 在 Visual Studio 2019 版本 16.10 或更高版本中可用。
/translateInclude 需要 /std:c++20 或更高版本。
在 Visual Studio 中设置此编译器选项
要启用 /translateInclude,请在项目属性对话框中,设置“将包含转换为导入”:
在项目属性页的左侧窗格中,选择“配置属性”>“C/C++”>“常规”。
将“将包含转换为导入”下拉列表更改为“是”。

选择“确定”或“应用”以保存更改。
另请参阅
/headerUnit(使用标头单元 IFC)。
/exportHeader(创建标头单元)
/reference(使用命名模块 IFC)
/scanDependencies
/sourceDependencies-directives
演练:在 Microsoft Visual C++ 中生成和导入标头单元