分享方式:


/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 中建置和匯入標頭單位