如何在Visual Studio中将DLL合并到EXE？

Question

在使用Visual Studio开发C#或VB.NET项目时，如何将多个引用的DLL文件合并到单一的EXE可执行文件中，以简化部署？默认情况下，.NET项目会将依赖的程序集编译为独立DLL，导致发布目录中包含大量附属文件。虽然可通过“添加引用”引入DLL，但无法自动嵌入至主EXE。常见疑问是：能否不借助第三方工具（如ILMerge或Costura.Fody），仅通过Visual Studio内置功能实现DLL合并？若需使用外部工具，应如何正确配置生成事件或NuGet包，确保DLL被安全、有效地嵌入并运行时动态加载？这是开发者在单文件分发场景下普遍关注的技术难题。

Answer 1

一、.NET项目中DLL合并的背景与挑战

在使用Visual Studio开发C#或VB.NET项目时，开发者常面临部署复杂性问题。默认情况下，.NET编译器会将项目引用的外部程序集（如NuGet包、自定义DLL等）输出为独立的DLL文件，与主EXE一同置于bin\Release目录下。这种分散式结构虽便于调试和模块化管理，但在分发桌面应用时显得繁琐。

用户期望“绿色发布”——即单个EXE即可运行，无需额外依赖文件。这引出一个核心问题：能否仅通过Visual Studio内置功能实现DLL合并？

• 对于传统.NET Framework项目，原生不支持自动嵌入所有依赖DLL至EXE。
• 即便将DLL设为“嵌入资源”，仍需手动加载逻辑，无法直接由CLR自动解析。
• 因此，单纯依靠“添加引用 + 属性设置”无法达成目标。

二、原生方案探索：从资源嵌入到运行时加载

尽管Visual Studio未提供一键合并功能，但可通过以下步骤模拟“内建合并”行为：

1. 将所需DLL添加为项目资源（右键项目 → 属性 → 资源 → 添加文件）。
2. 在AssemblyResolve事件中拦截缺失程序集请求。
3. 从嵌入资源流中读取并加载对应DLL。

static Program()
{
    AppDomain.CurrentDomain.AssemblyResolve += (sender, args) =>
    {
        string resourceName = "MyApp.Resources." + 
            new AssemblyName(args.Name).Name + ".dll";
        using (var stream = Assembly.GetExecutingAssembly()
            .GetManifestResourceStream(resourceName))
        {
            if (stream == null) return null;
            byte[] assemblyData = new byte[stream.Length];
            stream.Read(assemblyData, 0, assemblyData.Length);
            return Assembly.Load(assemblyData);
        }
    };
};

此方法完全基于.NET原生API，无需第三方工具，适用于对安全性要求高或受限环境。

三、现代解决方案对比分析

方案	是否需第三方工具	适用框架	生成方式	调试友好度
资源嵌入 + AssemblyResolve	否	.NET Framework	编译时嵌入	中等
ILMerge	是	.NET Framework	后编译合并	低
Costura.Fody	是	.NET Framework / .NET Core	编译时织入	高
.NET Single File Publish	否	.NET 5+	发布时打包	高
ILRepack	是	.NET Standard	开源替代ILMerge	中等

四、推荐实践路径：结合NuGet与构建自动化

以Costura.Fody为例，展示如何通过NuGet集成实现无缝合并：

1. 在Visual Studio中打开NuGet包管理器。
2. 搜索并安装Costura.Fody包（同时会引入Fody框架）。
3. 安装后，项目根目录自动生成FodyWeavers.xml文件。
4. 确认XML内容包含<Weaver><Costura/></Weaver>。
5. 重新生成项目，所有引用DLL将被自动嵌入主EXE。

其原理是在MSBuild编译后期，利用Fody的IL织入技术将DLL作为资源注入，并插入动态加载代码。

五、.NET 5+时代的原生单文件发布能力

从.NET 5开始，Microsoft引入了真正的“单文件发布”特性，标志着原生支持的到来：

<PropertyGroup>
  <PublishSingleFile>true</PublishSingleFile>
  <SelfContained>true</SelfContained>
  <RuntimeIdentifier>win-x64</RuntimeIdentifier>
</PropertyGroup>

只需在项目文件中添加上述配置，使用dotnet publish -r win-x64 --self-contained即可生成单一EXE。该EXE包含运行时、BCL及所有依赖项。

graph TD
    A[源代码] --> B[编译]
    B --> C{目标框架?}
    C -->|>= .NET 5| D[启用PublishSingleFile]
    C -->|.NET Framework| E[使用Costura.Fody或ILMerge]
    D --> F[生成单一可执行文件]
    E --> F
    F --> G[部署简化]