共用方式為

/exportHeader （建立標頭單位）

告知編譯器建立輸入引數所指定的標頭單位。 編譯器將標頭單元生成為 IFC （.ifc） 文件。

語法

/exportHeader /headerName:angle header-name
/exportHeader /headerName:quote header-name
/exportHeader full path to header file

Arguments

引數 to /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. 將 Configuration 下拉式清單設定為 All Configurations。 將 平台 下拉式清單設定為 所有平台。

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

  4. 使用下拉式控制項將 [編譯新檔] 屬性修改為 [編譯為 C++ 標頭單位] （/exportHeader）。 選擇 [確定] 或 [套用] 以儲存變更。

另請參閱

/headerName （從指定的標頭建置標頭單元）
/headerUnit （使用排針單元 IFC）
/reference （使用具名模組 IFC）
/translateInclude （將include指令翻譯成import指令）

  • Last updated on