共用方式為

/translateInclude

  • 發行項

這個參數會指示編譯器將 標頭檔案視為 #includeimport 已內建在標頭單元 （ .ifc ） 檔案中，以及使用 在命令列 /headerUnit 上指定的標頭檔。

搭配 /scanDependencies 或 /sourceDependencies-directives 使用 時，編譯器會在產生的相依性檔案中列為匯入的標頭單位，這些標頭同時包含在來源中，並在檔案中 header-units.json 具有對應的專案。 建置系統會使用此相依性資訊來產生已編譯的頭單元 .ifc 檔案。 建置標頭單位之後，編譯器會將它們視為 import ，而不是 #include 。

header-units.json只有在指定 時 /translateInclude ，才會參考檔案。 如需檔案格式和用途 header-units.json 的詳細資訊，請參閱 header-units.json 。

#include如果檔案未列在檔案中 header-units.json ，則會將其視為一般 #include 。

如需如何使用此參數的範例，請參閱 逐步解說：在 Microsoft Visual C++ 中建置和匯入標頭單位。

語法

/translateInclude

備註

/translateInclude 適用于 Visual Studio 2019 16.10 版或更新版本。
/translateInclude需要 /std：c++20 或更新版本。

在 Visual Studio 中設定這個編譯器選項

若要啟用 /translateInclude ，請在 [專案屬性] 對話方塊中，將 [翻譯包含] 設定 為 [匯入 ]：

  1. 在專案屬性頁的左側窗格中，選取 [組態屬性 > C/C++ > 一般]。

  2. 將 [ 翻譯包含] 下拉式 清單變更為 [是 ]。

    Screenshot of the Property Pages dialog with the Translate Includes to Imports property highlighted.

  3. 選擇 [確定 ] 或 [ 套用 ] 以儲存您的變更。

另請參閱

/headerUnit （使用標頭單位 IFC） 。
/exportHeader （建立標頭單位）
/reference （使用具名模組 IFC）
/scanDependencies
/sourceDependencies-directives
逐步解說：在 Microsoft Visual C++ 中建置和匯入標頭單位