C# 專案引用 COM 元件，打包部署時找不到參考怎麼辦？

問題情境：專案能跑，一打包就炸

開發 C# 專案時引用了 COM 元件，在開發機上用 VS2010 都能正常編譯執行。但只要把專案複製到另一台沒註冊該 COM 元件的電腦，用 VS2010 打開專案，原本的 COM 參考就變成黃色驚嘆號，找不到路徑。甚至把 COM 元件放到 debug 目錄下重新加參考，換台機器還是一樣失效。如何讓專案在未註冊 COM 的環境下也能直接編譯通過？

核心解決方案：兩大關鍵點

1. 強制 32 位元編譯（Platform target: x86）

若你的 COM 元件是 32 位元（大多數舊版 COM 都是），必須在專案屬性 → Build 中勾選 "Prefer 32-bit" 或明確設定 Platform target 為 x86。否則部署到 64 位元作業系統時，進程會以 64 位元模式執行，導致無法載入 32 位元 COM 元件，拋出 BadImageFormatException 或 COMException。

2. 打包工具勾選 Self-Registration

若使用 InstallShield Limited Edition 或 Professional 版打包：

• 在元件屬性中勾選 Self-Register 選項。
• 安裝程式執行時會自動呼叫 COM 元件的 DllRegisterServer，完成註冊動作，目標機器無需手動 regsvr32。

進階替代方案：Registration-Free COM (Reg-Free COM)

若不想依賴系統註冊表（如需無管理員權限部署、多版本共存），可採用 Registration-Free COM：

1. 在專案中將 COM 參考的 Isolated 屬性設為 True（VS 會自動產生 .manifest 檔）。
2. 打包時將 COM DLL 與產生的 YourApp.exe.manifest 放在同一目錄。
3. 執行時系統會優先讀取 Manifest 解析 COM 資訊，不查詢註冊表，實現「綠色部署」。

此方式需目標機器支援 Side-by-Side 組件（Windows XP SP2 以上皆支援）。

常見坑點提醒

• 位元數不匹配： 64 位元進程載入 32 位元 COM 是頭號錯誤來源，務必鎖定 x86。
• 相依性遺漏： COM 元件可能依賴其他 C++ Runtime（如 VC++ 2010/2013 Redist），打包時須一併包含。
• 權限問題： 註冊 COM 需管理員權限，若用戶無權限，Reg-Free COM 是唯一出路。

總結檢查清單

1. 專案屬性 → Build → Platform target: x86（或勾選 Prefer 32-bit）
2. COM 參考屬性 → Isolated = True（若採 Reg-Free）
3. InstallShield 專案 → COM 元件屬性 → Self-Register = Yes
4. 確認所有非托管相依 DLL（C++ Runtime 等）皆已納入安裝包

做好這幾點，你的 C# 專案就能在任何乾淨的 Windows 機器上「開箱即用」，不再為 COM 參考找不到而頭痛。