在 Visual Studio 中「重新生成解決方案」後出現 FileLoadException: 找到的程序集清單定義與程序集引用不匹配，通常是由於輸出路徑不一致或引用鏈條中存在多版本 DLL 導致。本文分析 NPOI 為例的典型成因並給出解決方案。
錯誤現象
- 完整重建方案後，調用 `OfficeUtility` 項目中的 `NPOIExcelUtil.ToExcel()` 拋出異常：
未能加載文件或程序集“NPOI, Version=2.1.3.0...”或它的某一個依賴項。找到的程序集清單定義與程序集引用不匹配。(HRESULT:0x80131040)
- 單獨重建 `OfficeUtility` 項目則正常。
核心成因分析
- 輸出路徑不一致： 方案中多個項目引用同一 DLL，但「輸出路徑」設置不同（如有的輸出到 `bin\Debug\`，有的輸出到統一的 `..\Lib\`）。完整重建時，MSBuild 複製順序導致舊版本覆蓋新版本，或反之。
- NuGet 套件版本不統一： 不同項目安裝了不同版本的 NPOI（如 2.1.3.0 vs 2.5.1），且未使用統一的套件管理策略。
- 「清理解決方案」未清理乾淨： 舊的 DLL 殘留在輸出目錄，重新生成時未被覆蓋。
解決方案（按推薦順序）
方案一：統一 NuGet 版本並集中管理（最佳實踐）
- 在方案上右鍵 →「管理方案的 NuGet 套件」→「整合」頁簽，查看 NPOI 版本是否一致。
- 將所有項目統一升級/降級到同一穩定版本（如
Install-Package NPOI -Version 2.5.6）。
- 啟用「包還原」，確保構建時自動下載正確版本。
方案二：統一輸出路徑或使用「複製本地」
- 將所有項目的「輸出路徑」設置為相對統一目錄（如 `$(SolutionDir)Bin\$(Configuration)\`）。
- 或在引用屬性中設置「複製本地 = True」，確保各項目輸出目錄下均有獨立副本（會增加體積但最省心）。
方案三：添加繫結重定向
在主項目（啟動項目）的 `app.config` / `web.config` 中強制重定向：
避坑指南
- 優先使用 PackageReference 格式（SDK 風格專案），避免 `packages.config` 的傳遞依賴問題。
- 定期執行「清理解決方案」+「重新生成」，或使用 `dotnet clean` / `msbuild /t:Clean` 確保乾淨構建。
- 遇到此類錯誤，先檢查 `bin\Debug` 目錄下實際的 DLL 版本（右鍵屬性→詳細信息），對比引用的版本。
通過統一版本管理與輸出路徑，可徹底根治「重新生成必報錯」的疑難雜癥。
