CorFlags.exe 完整指南：檢查與修改 .NET 組件平台目標（Any CPU / x86 / x64）

CorFlags.exe 是 .NET Framework SDK 附帶的命令列工具，專門用來**檢視**與**修改**組件標頭的 PE 格式、CorFlags 位元，進而判斷或改變組件的平台目標（Any CPU、x86、x64）。本文透過實測數據，詳細說明三種目標的 CorFlags 差異、如何用指令切換、以及不可逆的限制。

實測環境與編譯三版本

同一專案，分別設 Platform Target = Any CPU / x86 / x64 編譯，產生：

• EventPingPongAny.exe
• EventPingPongX86.exe
• EventPingPongX64.exe

CorFlags 輸出完整對照表

關鍵結論

• PE32 + 32BIT=0 → Any CPU：在 32-bit OS 跑 32-bit，在 64-bit OS 跑 64-bit。
• PE32 + 32BIT=1 → x86：永遠以 32-bit 載入（WoW64 下也跑 32-bit）。
• PE32+ + 32BIT=0 → x64：**只能在 64-bit OS 載入**，32-bit OS 直接報 BadImageFormatException。
• CorFlags = ILONLY(1) + 32BIT(2) = 3 即為 x86 組件特徵。

實用操作指令

1. 檢視組件旗標

corflags MyAssembly.exe
# 或
corflags MyAssembly.dll

2. 將 Any CPU 強制改為 x86（32BIT+）

corflags /32BIT+ MyAssembly.exe

執行後再次檢視，32BIT 變為 1，CorFlags 變為 3。組件現在只會以 32-bit 載入。

3. 還原回 Any CPU（32BIT-）

corflags /32BIT- MyAssembly.exe

32BIT 歸零，CorFlags 回到 1。

4. 移除強名簽名（若需修改已簽名組件）

corflags /Force MyAssembly.exe  # 強制更新（會移除簽名）

⚠️ 重要限制：x64 無法用 CorFlags 切換

因為 **x64 組件的 PE 格式是 PE32+**（64-bit），而 Any CPU / x86 都是 **PE32**（32-bit）。CorFlags **無法修改 PE 格式**，只能翻轉 CorFlags 位元。因此：

• ✅ Any CPU ↔ x86 **可雙向切換**（PE 同為 PE32）。
• ❌ Any CPU / x86 → x64 **不可行**（需重新編譯，Platform Target = x64）。
• ❌ x64 → Any CPU / x86 **不可行**（同理）。

常見應用場景

1. 修復「BadImageFormatException」：引用 32-bit 只能用的非受控 DLL（如 Oracle Client、某些 C++ SDK），主程式必須跑 x86。用 corflags /32BIT+ 快速修正編譯產出的 Any CPU 組件，無需重建專案。
2. CI/CD 管線自動修正：建置腳本中針對特定組件自動加 /32BIT+，確保部署環境相容。
3. 偵錯第三方組件平台：拿到無原始碼的 DLL，跑一下 corflags 即知是否需在 32-bit 模式運行。

進階：對應專案屬性設定

提示：Visual Studio 2012+ 預設啟用「Prefer 32-bit」，實際行為等同 x86（CorFlags=3）。若需真正 Any CPU（64-bit OS 跑 64-bit），請**取消勾選 Prefer 32-bit**。

工具取得路徑

• Visual Studio Developer Command Prompt / Developer PowerShell 直接輸入 corflags。
• 實體路徑通常在：C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.x Tools\CorFlags.exe

掌握 CorFlags，就能在「不重新編譯」或「無原始碼」情況下，快速診斷與修正平台相容性問題，是 .NET 開發/運維工具箱裡的利器。