引言

在部署 C# 桌面應(yīng)用（如 WinForms、WPF 或控制臺程序）時，我們常常面對一堆 .dll 文件——這不僅影響用戶體驗(yàn)，還容易導(dǎo)致依賴丟失或版本混亂。有沒有一種簡單、自動化的方式，把所有依賴“藏”進(jìn)主程序里？

答案是：Fody.Costura。

本文將手把手教你如何通過 NuGet 安裝 Fody.Costura，并配置項(xiàng)目，最終生成一個完全自包含的單一 EXE 文件。

一、什么是 Fody 和 Costura？

Fody：一個開源的 .NET 編譯時 IL（中間語言）織入框架，允許在編譯階段修改程序集。

Costura：Fody 的一個插件，專門用于將項(xiàng)目引用的所有程序集（包括 NuGet 包生成的 DLL）嵌入到主 EXE 中，并在運(yùn)行時自動解壓加載。

? 優(yōu)點(diǎn)：配置簡單，幾乎零代碼
支持 .NET Framework 4.0+ 和 .NET Core/.NET 5+（需注意兼容性）
自動處理 PDB（調(diào)試符號）和 XML 文檔
開源、社區(qū)活躍（GitHub 超 6k stars）

二、操作流程（Visual Studio）

步驟 1：創(chuàng)建或打開你的 C# 項(xiàng)目

確保你有一個可正常編譯運(yùn)行的項(xiàng)目，例如：

• 控制臺應(yīng)用（Console App）
• WinForms 應(yīng)用
• WPF 應(yīng)用

?? 注意：不適用于 ASP.NET Web 項(xiàng)目（因 IIS 加載機(jī)制不同）。

步驟 2：通過 NuGet 安裝 Fody 和 Costura

在 Visual Studio 中：

• 右鍵點(diǎn)擊你的項(xiàng)目 → “管理 NuGet 程序包”
• 切換到 “瀏覽” 選項(xiàng)卡
• 搜索并安裝包：Fody.Costura

實(shí)際上，安裝 Fody.Costura 會自動依賴并安裝 Fody，但建議確認(rèn)兩者都已正確安裝。

安裝完成后，你會看到項(xiàng)目根目錄下多出一個文件：FodyWeavers.xml。

步驟 3：檢查并配置 FodyWeavers.xml

打開 FodyWeavers.xml，內(nèi)容應(yīng)類似：

<?xml version="1.0" encoding="utf-8"?>
<Weavers xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="FodyWeavers.xsd">
  <Costura />
</Weavers>

這就是啟用 Costura 的標(biāo)志。默認(rèn)配置已足夠大多數(shù)場景使用。

常見可選配置（按需添加）：

<Costura
  IncludeDebugSymbols="true"        <!-- 是否嵌入 PDB -->
  DisableCompression="false"        <!-- 是否壓縮嵌入的 DLL（默認(rèn)壓縮） -->
  CreateTemporaryAssemblies="false" <!-- 是否在磁盤生成臨時 DLL（默認(rèn)不生成） -->
  Unmanaged64Assemblies="NativeLib64" <!-- 指定 64 位非托管 DLL 嵌入名 -->
  Unmanaged32Assemblies="NativeLib32" <!-- 指定 32 位非托管 DLL -->
/>

提示：一般保持默認(rèn)即可，除非你有特殊需求（如需要調(diào)試符號）。

步驟 4：重新編譯項(xiàng)目

清理解決方案（Build → Clean Solution）
重新生成（Build → Rebuild Solution）
編譯成功后，進(jìn)入輸出目錄（通常是 bin\Debug\netX.X 或 bin\Release\netX.X），你會發(fā)現(xiàn)：

主 EXE 文件依然存在（如 MyApp.exe）
所有原本的 .dll 文件不見了！
但程序仍能正常運(yùn)行！
這是因?yàn)?Costura 已將所有依賴 DLL 作為資源嵌入到了 EXE 中，并在程序啟動時通過 AppDomain.CurrentDomain.AssemblyResolve 事件動態(tài)加載。

步驟 5：驗(yàn)證是否成功合并

你可以用以下方式驗(yàn)證：

方法 A：直接運(yùn)行 EXE
將 MyApp.exe 復(fù)制到一個空文件夾中，雙擊運(yùn)行。如果程序正常啟動，說明合并成功。

方法 B：使用反編譯工具查看資源
用 ILSpy 或 dnSpy 打開 EXE，展開 “Resources”，你會看到類似：

costura.system.windows.forms.dll
costura.newtonsoft.json.dll

這些就是被嵌入的依賴項(xiàng)。

三、高級技巧與注意事項(xiàng)

1. 排除某些 DLL 不合并

如果你希望某些 DLL 不被嵌入（例如插件或需外部更新的模塊），可在項(xiàng)目文件中添加：

<ItemGroup>
  <Reference Include="SomeExternalLib">
    <Private>false</Private>
    <CopyLocal>false</CopyLocal>
  </Reference>
</ItemGroup>

或者在引用上右鍵 → 屬性 → 將 “復(fù)制本地” 設(shè)為 False。

2. 支持非托管 DLL（如 C++ 編寫的 .dll）

Costura 也支持嵌入非托管 DLL（native DLL），但需手動指定名稱：

<Costura
  Unmanaged32Assemblies="mylib_x86"
  Unmanaged64Assemblies="mylib_x64" />

并將你的 mylib_x86.dll 和 mylib_x64.dll 設(shè)置為 “嵌入的資源”（Build Action = Embedded Resource）。

3. 調(diào)試時仍能看到 PDB？

默認(rèn)情況下，Debug 模式會嵌入 PDB，Release 模式不會?？赏ㄟ^ IncludeDebugSymbols=“true” 強(qiáng)制包含。

四、總結(jié)

通過 Fody.Costura，我們只需兩步（安裝 NuGet + 編譯），就能將整個 C# 應(yīng)用打包成一個干凈、獨(dú)立的 EXE 文件，極大簡化部署和分發(fā)流程。

核心優(yōu)勢：零代碼侵入、全自動、兼容性強(qiáng)

趕快在你的項(xiàng)目中試試吧！

到此這篇關(guān)于將C#項(xiàng)目打包為單一exe的完整指南的文章就介紹到這了,更多相關(guān)C#項(xiàng)目打包為單一exe內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論