共用方式為


/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 已編譯檔案。

  1. 若要在 IDE 中明確將 /exportHeader 選項套用至檔案,請選取 方案總管 中的 檔案。 以滑鼠右鍵按一下以開啟操作功能表,然後選取 [ 屬性] 以開啟 [屬性 頁] 對話方塊。

  2. 將 [組態 ] 下拉式 清單設定為 [所有組態 ]。 將 [ 平臺] 下拉式清單設定為 [所有平臺 ]。

  3. 開啟 [ 組態屬性 > C/C++ > 進階 ] 屬性頁。

  4. 使用下拉式清單控制項修改 Compile As 屬性,以 編譯為 C++ 標頭單位 (/exportHeader) 。 選擇 [確定 ] 或 [ 套用 ] 以儲存您的變更。

另請參閱

/headerName (從指定的標頭建置標頭單位)
/headerUnit (使用標頭單位 IFC)
/reference (使用具名模組 IFC)
/translateInclude (將 include 指示詞轉譯為 import 指示詞)