共用方式為

/FA、 /Fa （列出檔案）

  • 發行項

建立包含組合語言程式程式碼的清單檔案。

語法

/FA[c][s][u]
/Fa路徑

備註

編譯 /FA 程式選項會產生編譯中每個轉譯單位的組合語言程式清單檔案，這通常對應至 C 或 C++ 原始程式檔。 根據預設，只會將組合語言程式包含在清單檔案中，該檔案會編碼為 ANSI。 選擇性 c 、 s 和 u 引數，可 /FA 控制機器碼或原始程式碼是否與組合器清單一起輸出，以及清單是否編碼為 UTF-8。

根據預設，每個清單檔案都會取得與原始程式檔相同的基底名稱，而且副檔名為 .asm 。 使用 c 選項包含機器碼時，清單檔案具有 .cod 副檔名。 您可以使用 選項來變更清單檔案的名稱和副檔名，以及其建立 /Fa 所在的目錄。

/FA 參數

none
清單中只會包含組合語言。

c
選擇性。 在清單中包含機器碼。

s
選擇性。 在清單中包含原始程式碼。

u
選擇性。 以 UTF-8 格式編碼清單檔案，並包含位元組順序標記。 根據預設，檔案會編碼為 ANSI。 使用 u 來建立在任何系統上正確顯示的清單檔，或者如果您使用 Unicode 原始程式碼檔案作為編譯器的輸入。

如果同時 s 指定 和 u ，而且原始程式碼檔案使用 UTF-8 以外的 Unicode 編碼，則檔案中的 .asm 程式程式碼可能無法正確顯示。

/Fa 參數

none
編譯中的每個原始程式碼檔案都會建立一個 source.asm 檔案。

檔案名稱
編譯器會將名為 filename.asm 的清單檔案放在目前目錄中。 只有在編譯單一原始程式碼檔案時，這個引數表單才有效。

filename.extension
編譯器會將名為 filename.extension 的清單檔放在目前目錄中。 只有在編譯單一原始程式碼檔案時，這個引數表單才有效。

目錄\
編譯器會針對編譯中的每個原始程式碼檔案建立一個 source_file.asm 檔案。 它會放在指定的 目錄中 。 需要尾端反斜線。 只允許目前磁片上的路徑。

目錄 \ 檔案名
名為 filename.asm 的清單檔案 會放在指定的 目錄中 。 只有在編譯單一原始程式碼檔案時，這個引數表單才有效。

directory \ filename.extension
名為 filename.extension 的清單檔案會放在指定的 目錄中 。 只有在編譯單一原始程式碼檔案時，這個引數表單才有效。

在 Visual Studio 開發環境中設定這個編譯器選項

  1. 開啟專案的 [屬性頁] 對話方塊。 如需詳細資料，請參閱在 Visual Studio 中設定 C ++ 編譯器和組建屬性。

  2. 選取 [組態屬性]>C/C++>[輸出檔案] 屬性頁。

  3. 修改 Assembler Output 屬性，以設定組合器、電腦和原始程式碼的 /FAc 和 /FA 選項。 修改 [使用 Unicode For Assembler List ] 屬性來設定 /FAu ANSI 或 UTF-8 輸出的選項。 修改 ASM 清單位置 ，以設定 /Fa 列出檔案名和位置的選項。

設定組合器輸出 和使用 Unicode 進行組合器清單 屬性可能會導致 命令列警告 D9025 。 若要在 IDE 中結合這些選項，請改用 命令列 屬性頁中的 [其他選項 ] 欄位。

若要以程式方式設定這個編譯器選項

範例

下列命令列會產生稱為 HELLO.cod 的合併來源和電腦程式代碼清單：

CL /FAcs HELLO.CPP

另請參閱

輸出檔 (/F) 選項
MSVC 編譯器選項
MSVC 編譯器命令列語法
指定路徑名稱