共用方式為

/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。

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

語法

/translateInclude

備註

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

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

若要啟用 /translateInclude，請在 [項目屬性] 對話框中，將 [翻譯包含] 設定 為 [匯入]：

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

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

    [屬性頁] 對話框的螢幕快照，其中已醒目提示 [翻譯包含至匯入] 屬性。

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

另請參閱

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