萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

.NET 專案合併多個組件 (DLL) 為單一檔案:ILMerge、Costura.Fody、內嵌資源三大方案比較

將多個專案組件 (DLL) 合併為單一執行檔,可簡化部署、避免 DLL Hell、保護智慧財產。本文比較三種主流方案:**ILMerge (傳統)**、**Costura.Fody (編織/內嵌資源)**、**單一專案多檔案編譯 (Source Merge)**,並說明適用條件、限制與遷移建議。

方案比較總覽

方案原理支援 .NET Framework支援 .NET Core / .NET 5+強名稱/簽署PDB 除錯符號維護狀態
ILMerge後處理合併 IL✅ 完整❌ 不支援需額外簽署支援維護模式 (2018 後無更新)
Costura.Fody編譯期織入,DLL 內嵌為資源,運行時解壓✅✅ (需 Fody 6+)自動保留支援活躍
單一專案多檔案 (Source Merge)將所有 .cs 納入同一專案編譯✅✅原生原生原生支援
.NET Core 單檔發佈`PublishSingleFile=true` + `IncludeNativeLibrariesForSelfExtract`❌✅ 原生原生原生官方標準

方案一:ILMerge (僅 .NET Framework)

// 安裝
nuget install ILMerge -Version 3.0.41

// 命令列合併
ilmerge /out:MergedApp.exe /target:exe /targetplatform:v4,C:\Windows\Microsoft.NET\Framework\v4.0.30319 \
    Primary.exe Lib1.dll Lib2.dll /ndebug /copyattrs /log:ilmerge.log

// 專案後建置事件自動化
"$(SolutionDir)packages\ILMerge.3.0.41\tools\ilmerge.exe" /out:"$(TargetDir)Merged.$(TargetFileName)" "$(TargetPath)" "$(TargetDir)Lib1.dll" "$(TargetDir)Lib2.dll" /target:library /ndebug

⚠️ **限制**:不支援 .NET Core/.NET 5+、WPF 資源合併易出錯、強名稱需額外 `sn -Ra`。

方案二:Costura.Fody (推薦舊專案)

  1. 安裝 NuGet:`Install-Package Costura.Fody` (會自動安裝 Fody)。
  2. 專案根目錄產生 `FodyWeavers.xml`:
<Weavers xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="FodyWeavers.xsd">
  <Costura CreateTemporaryAssemblies="false" IncludeDebugSymbols="true" />
</Weavers>
  1. 建置即完成:輸出單一 EXE/DLL,參考組件被內嵌為資源,首次載入時自動解壓至暫存目錄。

✅ **優點**:零程式碼修改、支援強名稱、保留 PDB、支援 .NET Framework 4.6.2+ / .NET Core 3.1+ (Fody 6+)。

方案三:單一專案多檔案編譯 (Source Merge)

將多個類庫專案的 `.cs` 檔案以 `` 方式納入主專案 `.csproj`,或使用 `` + `All` 配合 `EmbedInteropTypes`。本質上是原始碼層面合併,無任何運行時額外負擔。

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup><OutputType>Exe</OutputType><TargetFramework>net48</TargetFramework></PropertyGroup>
  <ItemGroup>
    <Compile Include="..\Lib1\**\*.cs" Exclude="..\Lib1\obj\**;..\Lib1\bin\**;..\Lib1\Properties\AssemblyInfo.cs" />
    <Compile Include="..\Lib2\**\*.cs" Exclude="..\Lib2\obj\**;..\Lib2\bin\**;..\Lib2\Properties\AssemblyInfo.cs" />
  </ItemGroup>
</Project>

⚠️ **注意**:命名空間衝突、內部類別可見度變更、專案結構耦合。適合**完全自有原始碼**且團隊同意合併倉庫時。

方案四:.NET 5+ 官方單檔發佈 (新專案首選)

dotnet publish -r win-x64 -c Release /p:PublishSingleFile=true /p:IncludeNativeLibrariesForSelfExtract=true /p:EnableCompressionInSingleFile=true
  • 輸出單一 `.exe`,包含所有 Managed DLL、Native 庫 (可選)、Runtime (Self-contained)。
  • 啟動稍慢 (首次解壓),但無第三方工具依賴、官方長期支援。

選型決策樹

目標框架?
├─ .NET Framework 4.x (舊專案)
│   ├─ 需保留獨立 DLL 給其他程式參考? → 否 → Costura.Fody (最省力)
│   └─ 必須合併為單一檔案? → ILMerge (若 Costura 失敗)
├─ .NET Core 3.1 / .NET 5+ (新專案)
│   ├─ Self-contained 單檔? → `PublishSingleFile=true` (官方標準)
│   └─ Framework-dependent 單檔? → `PublishSingleFile=true` + `SelfContained=false`
└─ 完全自有原始碼且願意合併專案 → Source Merge (csproj Include)

常見坑點

  • **反射載入組件** (`Assembly.Load("Lib1")`) 合併後失效 → 改用 `typeof(SomeTypeInLib1).Assembly`。
  • **嵌入資源** (圖片、XML) 路徑變更 → 合併後資源在主組件,需用 `Assembly.GetExecutingAssembly().GetManifestResourceStream`。
  • **配置檔** (`web.config`/`app.config`) 不會被合併,需手動處理。
  • **授權檢查** 某些商業庫檢測自身 DLL 存在 → 合併後失效,需聯繫廠商。

依專案框架、原始碼擁有權、部署限制選擇合適方案;現代 .NET 專案請優先使用官方單檔發佈,舊專案以 Costura.Fody 為最佳平衡點。

copyright © 萬盛學電腦網 all rights reserved