共用方式為

/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 指示詞）