共用方式為


/MP (使用多處理序建置)

更新:2011 年 4 月

/MP 選項會使編譯器在不同的處理序中,建立一個或多個本身的複本。 這些複本會同時編譯原始程式檔, 使得建置原始程式檔的總時間大幅的降低。

/MP[processMax]

引數

  • processMax
    (選擇性) 編譯器可建立的處理序數目上限。

    processMax 引數必須是在從 1 到 65536 的範圍。 否則,編譯器就會發出警告訊息 D9014,忽略 processMax 引數,並假設處理序的最大數目是 1。

    如果您略過 processMax 引數,則編譯器會從作業系統擷取電腦上的有效的處理器之數目,並為每一個處理器建立一個處理序。

備註

/MP 編譯器選項可以在您編譯許多檔案時,大幅縮短建置時間。 為了縮短建置時間,編譯器最多會建立processMax 個本身的複本,然後使用這些複本同時編譯原始程式檔。 /MP 選項會套用於編譯,但不套用於連結或連結時間的程式碼產生。 /MP 選項預設為關閉。

建置時間的改善,必須視電腦上的處理器數目、要編譯的檔案數目、系統資源 (例如 I/O 容量) 是否可用等因素而定。 您可以嘗試 /MP 選項,以決定建置特定專案的最佳設定。 如需建議以輔助您做決定,請參閱使用方針。

不相容的選項和語言功能

/MP 選項與某些編譯器選項和語言功能不相容。 如果您使用的編譯器選項和 /MP 選項不相容,則編譯器會發出警告 D9030,並忽略 /MP 選項。 如果您使用不相容的語言功能,則編譯器會發出錯誤 C2813,然後視目前編譯器警告層級的選項結束或繼續。

注意事項注意事項

大部分的選項都不相容,因為如果允許這些選項,則同時執行編譯器時就會同時將輸出寫入至主控台或特定檔案中。 結果,輸出就會相互混在一起而且不完整。 有時候,結合其他選項還會使效能變得更差。

下表列出與 /MP 選項不相容的編譯器選項和語言功能:

選項或語言功能

描述

#import 前置處理器指示詞

將型別程式庫中的型別轉換成 C++ 類別,然後將這些類別寫入至標頭檔。

/E, /EP

將前置處理器輸出複製至標準輸出 (stdout)。

/Gm

允許累加重新建置。

/showIncludes

將 Include 檔的清單寫入至標準錯誤 (stderr)。

/Yc

寫入先行編譯的標頭檔。

診斷訊息

如果您指定與 /MP 選項不相容的選項或語言功能,就會收到診斷訊息。 下表列出編譯器的訊息和行為:

診斷訊息

描述

編譯器行為

C2813

#import 指示詞與 /MP 選項不相容。

除非另外指定編譯器警告層級選項,否則編譯就會結束。

D9014

為 processMax 引數指定了無效值。

編譯器會忽略無效值,並假設值為 1。

D9030

指定的選項與 /MP 不相容。

編譯器會忽略 /MP 選項。

方針

測量效能

使用總建置時間來測量效能。 您可以使用實體時鐘來計算建置時間,或使用軟體來計算建置開始到停止間的時間差。 如果您的電腦有多個處理器,則以實體時鐘計算出來的時間可能比軟體時間測量更精確。

有效的處理器

電腦的每一個實體處理器都可以有一個或多個虛擬處理器,又稱為有效的處理器。 每一個實體處理器都可以有一個或多個核心,而且如果作業系統允許核心的超執行緒,則每一個核心都會顯示成兩個虛擬處理器。

例如,如果電腦有一個實體處理器,而處理器有一個核心且停用超執行緒,則該電腦會有一個有效的處理器。 相反地,如果電腦有兩個實體處理器,每一個都有兩個核心,且所有核心都啟用超執行緒,則這部電腦就有八個有效的處理器。 也就是,(8 個有效的處理器) = (2 個實體處理器) x (每個實體處理器有 2 個核心) x (因為超執行緒,所以每個核心都有 2 個有效的處理器)。

如果您在 /MP 選項中略過 processMax 引數,則編譯器會取得作業系統中有效處理器的數目,然後為每個有效的處理器建立一個處理序。 但是,編譯器無法保證哪個處理序會在特定處理器上執行,這是由作業系統決定。

處理序的數目

編譯器會計算要用來編譯原始程式檔的處理序數目。 您在命令列上所指定的原始程式檔數目,以及使用 /MP 選項明確或隱含指定的處理序數目,兩者中較小的那個數目就是處理序的數目值。 如果您提供 /MP 選項的 processMax 引數,就可以明確設定處理序數目的最大值。 或者,如果您略過 processMax 引數,可以使用預設值,也就是電腦中的有效處理器之數目。

例如,假設您指定下列命令列:

cl /MP7 a.cpp b.cpp c.cpp d.cpp e.cpp

在此情況下,編譯器會使用五個處理序,因為五個原始程式檔和最多七個處理序這兩個數字中,這是較小的數目。 或者,假設您的電腦有兩個有效的處理器,而且您指定下列命令列:

cl /MP a.cpp b.cpp c.cpp

此時,作業系統會報告兩個處理器,因此編譯器會在計算中使用兩個處理序。 結果,編譯器會使用兩個處理序來執行建置,因為兩個處理序和三個原始程式檔這兩個數字中,這是較小的數目。

原始程式檔和建置順序

原始程式檔編譯的順序,可能和它們出現在命令列中的順序不同。 雖然編譯器會建立一組處理序,內含編譯器的複本,但是作業系統會排程每一個處理序何時執行。 因此,您無法保證原始程式檔會以特定順序編譯。

當處理序可用來編譯時,就會編譯原始程式檔。 如果檔案比處理序還多,可用的處理序就會編譯第一組檔案。 當處理序處理完前一個檔案,且可以再處理其中一個剩下的檔案時,就會處理剩下的檔案。

請勿在命令列上多次指定相同的原始程式檔。 如果工具自動建立 makefile (根據專案中的相依性資訊),就可能會發生這種情況。 如果您不指定 /MP 選項,則編譯器會依序處理檔案清單,並重新編譯檔案。 但是,如果您指定 /MP 選項,則不同的編譯器可能會同時編譯同一個檔案。 因此,不同的編譯器會同時嘗試寫入同一個輸出檔。 一個編譯器會取得輸出檔的獨佔寫入權限並成功,另一個編譯器則會失敗並發生檔案存取錯誤。

使用型別程式庫 (#import)

編譯器不支援使用 #import 指示詞搭配 /MP 參數。 如果可以,請遵循這些步驟來解決這個問題:

  • 將各原始程式檔中的所有 #import 指示詞移動至一個或多個檔案,然後不使用 /MP 選項編譯這些檔案。 結果會產生一組標頭檔。

  • 在剩下的原始程式檔中,插入 #include 指示詞 (指定產生的標頭),然後使用 /MP 選項編譯剩下的原始程式檔。

Visual Studio 專案設定

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

  1. 開啟專案的 [屬性頁] 對話方塊。 如需詳細資訊,請參閱 HOW TO:開啟專案屬性頁

  2. 按一下[組態屬性]。

  3. 按一下 [C/C++]。

  4. 按一下 [一般]。

  5. 設定 [多處理器編譯] 屬性中的編譯器選項。

MSBUILD.exe 工具

Visual Studio 會使用 MSBuild.exe 工具來建置方案和專案。 MSBuild.exe 工具 的 **/maxcpucount:number(或/m:**number) 命令列選項可以同時組建多個專案。 /MP 編譯器選項同時組建多個編譯單位。 如果適合您的應用程式,請使用 /MP/maxcpucount 或兩者一起使用,以改善您的方案建置時間。

方案的建置時間,部分需視執行建置的處理序之數目而定。 /maxcpucount MSBuild 選項的 number 引數會指定要同時建置的專案數目上限。 同樣地,/MP 編譯器選項的 processMax 引數會指定要同時建置的編譯單位數目上限。 如果 /maxcpucount 選項指定 P 專案,而 /MP 選項指定 C 處理序,則最多 P x C 個處理序會同時執行。

決定是否使用 MSBuild/MP 技術的方針如下:

  • 如果每個專案內都只有幾個檔案,請使用 MSBuild 工具。

  • 如果有少數幾個專案有很多檔案,請使用 /MP 選項。

  • 如果專案數目及每個專案的檔案數目平衡,請使用 MSBuild/MP。 一開始,將 /maxcpucount 選項設定為要建置的專案數目,/MP 選項則設定為電腦上的處理器數目。 測量效能然後調整設定,以產生最佳結果。 重複這個循環,直到您滿意總建置時間為止。

/Gm 編譯器選項

根據預設,專案建置會針對偵錯組建 (Debug Build) 啟用 /Gm 編譯器選項 (累加建置),針對發行的組件 (Release Build) 則停用此選項。 因此,偵錯組建中的 /MP 編譯器選項會自動停用,因為這個選項和預設的 /Gm 編譯器選項衝突。

請參閱

參考

#import Directive (C/C++)

MSBuild 命令列參考

變更記錄

日期

記錄

原因

2011 年 4 月

只訂如何在開發環境中設定 /MP 選項。

客戶回函。