如何将NuGet依赖项嵌入.dll程序集，使其成为自包含组件？

当然可以，下面是几种成熟的实现方案，能让你的projectA.dll成为不依赖外部NuGet包的自包含组件：

1. 使用Costura.Fody（最简便的自动化方案） #

这是.NET生态中最常用的依赖嵌入工具，无需手动处理细节：

• 在projectA项目中安装Costura.Fody NuGet包
• 编译项目时，Costura会自动扫描所有依赖的NuGet托管程序集，将它们嵌入到最终生成的projectA.dll中
• 运行时，Costura会自动从嵌入资源中提取并加载这些依赖，完全无需额外代码

如果依赖的是非托管原生DLL，只需将这些DLL放在项目的特定目录（如Costura32/Costura64），Costura也会一并嵌入并在运行时自动处理加载路径。

2. 使用ILMerge（手动合并工具） #

ILMerge是微软官方提供的程序集合并工具，适合需要手动控制合并过程的场景：

• 下载ILMerge工具（可通过NuGet安装ILMerge包获取）
• 使用命令行将projectA.dll和所有依赖的NuGet DLL合并为一个单独的DLL：

  ILMerge /out:SelfContainedProjectA.dll ProjectA.dll Dependency1.dll Dependency2.dll
  

• 注意：ILMerge仅支持托管程序集，非托管DLL无法用此工具合并，需要单独处理。

3. .NET Core/.NET 5+ 手动嵌入资源（自定义控制方案） #

如果需要更精细的控制，可以手动将依赖嵌入为资源并在运行时加载：

1. 在projectA的项目文件中，将依赖的NuGet DLL标记为嵌入资源：

   <ItemGroup>
     <EmbeddedResource Include="path/to/your/dependency.dll">
       <CopyToOutputDirectory>Never</CopyToOutputDirectory>
     </EmbeddedResource>
   </ItemGroup>
   

2. 在projectA中添加初始化逻辑，在程序启动时从嵌入资源中提取并加载依赖：

   using System;
   using System.IO;
   using System.Reflection;
   
   namespace ProjectA
   {
       static class DependencyBootstrapper
       {
           static DependencyBootstrapper()
           {
               LoadEmbeddedDependency("ProjectA.Dependency.dll");
           }
   
           private static void LoadEmbeddedDependency(string resourceName)
           {
               var assembly = Assembly.GetExecutingAssembly();
               using var resourceStream = assembly.GetManifestResourceStream(resourceName);
               if (resourceStream == null) return;
   
               var tempPath = Path.Combine(Path.GetTempPath(), Path.GetFileName(resourceName));
               if (!File.Exists(tempPath))
               {
                   using var fileStream = File.Create(tempPath);
                   resourceStream.CopyTo(fileStream);
               }
   
               Assembly.LoadFrom(tempPath);
           }
       }
   
       // 确保初始化逻辑被触发，可在ProjectA的入口类中添加静态构造函数调用
       public class SomeClassInProjectA
       {
           static SomeClassInProjectA() => _ = typeof(DependencyBootstrapper);
       }
   }
   

关键注意事项 #

• 许可合规性：部分NuGet包的开源许可禁止静态嵌入或分发合并后的程序集，需要先确认依赖包的许可条款。
• 版本冲突：如果projectB本身也引用了相同的NuGet包但版本不同，嵌入后可能引发版本冲突，需充分测试。
• 非托管依赖：非托管DLL无法直接合并到托管程序集中，必须嵌入后在运行时提取到临时目录，再通过DllImport或手动加载。

内容的提问来源于stack exchange，提问作者user4779