/exportHeader
(建立標頭單位)
告知編譯器建立輸入引數所指定的標頭單位。 編譯器會產生標頭單位作為 IFC ( .ifc
) 檔案。
語法
/exportHeader /headerName:angle
header-name
/exportHeader /headerName:quote
header-name
/exportHeader
full path to header file
引數
的引數 /exportHeader
是 /headerName
命令列選項,指定要匯出之標頭檔的名稱 header-name
。
備註
/exportHeader
從 Visual Studio 2019 16.10 版開始提供。
編譯 /exportHeader
程式選項需要您啟用 /std:c++20
或更新版本的編譯器選項 (例如 /std:c++latest
)。
一個 /exportHeader
編譯器選項可以指定組建所需的多個標頭名稱引數。 您不需要個別指定它們。
使用此選項時,編譯器會隱含地啟用新的預處理器。 也就是說, /Zc:preprocessor
如果命令列上使用任何形式的 /exportHeader
,編譯器就會新增至命令列。 若要退出宣告隱含 /Zc:preprocessor
,請使用: /Zc:preprocessor-
根據預設,編譯器不會在編譯標頭單位時產生物件檔。 若要產生物件檔,請指定 /Fo
編譯器選項。 如需詳細資訊,請參閱 /Fo
(目的檔名) 。
您可能會發現使用互補選項 /showResolvedHeader
會很有説明。 選項 /showResolvedHeader
會列印引數所解析之檔案 header-name
的絕對路徑。
/exportHeader
可以一次處理多個輸入,即使在 下 /MP
也是如此。 建議您使用 /ifcOutput <directory>
來為每個編譯建立個別 .ifc
的檔案。
範例
若要建置標頭單位,如下所示 <vector>
:
cl . . . /std:c++latest /exportHeader /headerName:angle vector
建置本機專案標頭,如下所示 "utils/util.h"
:
cl . . . /std:c++latest /exportHeader /headerName:quote util/util.h
在 Visual Studio 開發環境中設定這個編譯器選項
除非您對標頭檔使用不同的副檔名,否則您通常不應該在 Visual Studio 開發環境中設定此選項。 根據預設,建置系統會將此選項套用至副檔名為或沒有副檔名的 .h
已編譯檔案。
若要在 IDE 中明確將
/exportHeader
選項套用至檔案,請選取 方案總管 中的 檔案。 以滑鼠右鍵按一下以開啟操作功能表,然後選取 [ 屬性] 以開啟 [屬性 頁] 對話方塊。將 [組態 ] 下拉式 清單設定為 [所有組態 ]。 將 [ 平臺] 下拉式清單設定為 [所有平臺 ]。
開啟 [ 組態屬性 > C/C++ > 進階 ] 屬性頁。
使用下拉式清單控制項修改 Compile As 屬性,以 編譯為 C++ 標頭單位 (/exportHeader) 。 選擇 [確定 ] 或 [ 套用 ] 以儲存您的變更。
另請參閱
/headerName
(從指定的標頭建置標頭單位)
/headerUnit
(使用標頭單位 IFC)
/reference
(使用具名模組 IFC)
/translateInclude
(將 include 指示詞轉譯為 import 指示詞)
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應