Visual Studio 2010 C++ 專案並行建置調優指南：/MP、MSBuild /m、屬性表與條件式調整

兩層並行機制

設定步驟圖解

1. 方案層：
2. 專案層 /MP：
3. .vcxproj 中的 MultiProcessorCompilation：

命令列建置

msbuild MySolution.sln /m:4 /p:CL_MPCount=2
/m:4          -> MSBuild 同時建置 4 個專案
/p:CL_MPCount=2 -> 傳遞給 CL 的 /MP2 (每專案 2 個平行編譯)

注意：VS IDE 內建置不受 CL_MPCount 環境變數影響，需在專案屬性或 .vcxproj 設定。

屬性表 (.props) 共享 /MP 設定

1. 檢視 > 視窗 > 屬性管理器 (或 專案 > 屬性管理器)。
2. 右鍵專案 > 加入新專案屬性表，命名 MultiprocCpp.props。
3. 編輯該 .props，設定 C/C++ > 一般 > 多處理器編譯 = 是。
4. 儲存後，多專案同時選取 > 右鍵 > 加入現有屬性表 選取此 .props。

條件式調整：依機器核心數自動縮放

<PropertyGroup Condition="'$(MultiprocCLCount)' != '' and '$(MultiprocCLCount)' > '0'">
  <MultiProcessorCompilation>true</MultiProcessorCompilation>
  <ProcessorNumber>$(MultiprocCLCount)</ProcessorNumber>
</PropertyGroup>

• 開發機設定環境變數 MultiprocCLCount=2。
• 建置伺服器設定 MultiprocCLCount=8。
• 同一份 .props/.vcxproj 即可自適應。

避免過度並行導致系統卡頓

若方案 8 專案皆開 /MP8，MSBuild /m8 啟動 → 64 個 cl.exe 同時執行，CPU/磁碟/記憶體飽和反而變慢。

建議策略

• 全域 /m 設為核心數 減 1 或 2 (留資源給 OS/IDE)。
• 專案層 /MP 視專案大小調整：大專案 /MP4，小專案 /MP1 (關閉)。
• Release 建置優化耗時長，適合開 /MP；Debug 建置快，可關閉減少負載。
• 使用 #import、/Gm (增量編譯) 的檔案 必須關閉 /MP (在檔案屬性 C/C++ > 一般 > 多處理器編譯 = 否)。

<ClCompile Include="Heavy.cpp">
  <MultiProcessorCompilation>true</MultiProcessorCompilation>
  <ProcessorNumber>2</ProcessorNumber> <!-- 此檔最多 2 平行 -->
</ClCompile>