/translateInclude
這個參數會指示編譯程式將標頭檔案視為#include
import
已內建在標頭單元 (.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
,請在 [項目屬性] 對話框中,將 [翻譯包含] 設定 為 [匯入]:
在專案屬性頁的左側窗格中,選取 [組態屬性>C/C++>一般]。
將 [ 翻譯包含] 下拉式 列表變更為 [是]。
選擇 [確定] 或 [套用] 以儲存變更。
另請參閱
/headerUnit
(使用標頭單位 IFC) 。
/exportHeader
(建立標頭單位)
/reference
(使用具名模組 IFC)
/scanDependencies
/sourceDependencies-directives
逐步解說:在 Visual C++ Microsoft 中建置和匯入標頭單位