如何将预编译.NET 6 DLL及依赖打包为带可配置参数的单文件可执行程序？

方法1：基于dotnet publish的轻量启动器方案 #

你可以通过一个极简的启动器项目，配合dotnet publish单文件功能实现需求，全程无需修改主DLL源码：

1. 创建空控制台项目作为启动器：

   dotnet new console -n AppLauncher
   cd AppLauncher
   

2. 引用你的已编译主DLL（替换为实际路径）：

   dotnet add reference ../YourMainApp/bin/Release/net6.0/YourMainApp.dll
   

3. 修改Program.cs，直接调用主DLL的入口方法：

   using YourMainAppNamespace; // 替换为你的主DLL命名空间
   
   // 调用主程序入口
   Program.Main(args);
   

4. 添加配置文件（如appsettings.json）到启动器项目，在AppLauncher.csproj中设置为嵌入资源：

   <ItemGroup>
     <EmbeddedResource Include="appsettings.json">
       <CopyToOutputDirectory>Never</CopyToOutputDirectory>
     </EmbeddedResource>
   </ItemGroup>
   

5. 主DLL中读取嵌入的配置：

   using System.Reflection;
   using Microsoft.Extensions.Configuration;
   
   var entryAssembly = Assembly.GetEntryAssembly();
   using var configStream = entryAssembly.GetManifestResourceStream("AppLauncher.appsettings.json");
   var config = new ConfigurationBuilder()
       .AddJsonStream(configStream)
       .Build();
   // 使用config对象获取配置值
   

6. 修改配置后，直接重新发布启动器即可生成带新配置的单文件EXE：

   # 替换为目标平台，如linux-x64、osx-x64
   dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true
   

方法2：ILRepack+程序集链接器组合方案 #

用ILRepack合并DLL，再通过官方工具嵌入配置，完全脱离dotnet publish：

1. 用ILRepack合并主DLL和所有依赖（需提前安装ILRepack）：

   ILRepack /out:MergedApp.dll YourMainApp.dll DependencyA.dll DependencyB.dll
   

2. 把配置文件编译为资源文件（使用.NET自带的resgen工具）：

   resgen appsettings.json AppConfig.resources
   

3. 用程序集链接器al.exe将合并后的DLL和配置资源打包为单文件EXE：

   # 替换主类命名空间和类名
   al /out:YourApp.exe /target:exe /main:YourMainAppNamespace.Program /embed:AppConfig.resources,MergedApp.AppConfig.resources
   

4. 主DLL中读取嵌入的配置资源：

   using System.Resources;
   using System.Reflection;
   using Newtonsoft.Json;
   
   var resourceManager = new ResourceManager("MergedApp.AppConfig", Assembly.GetExecutingAssembly());
   var configJson = resourceManager.GetString("appsettings.json");
   var config = JsonConvert.DeserializeObject<YourConfigType>(configJson);
   

   每次修改配置后，重新执行resgen和al命令即可生成新的单文件EXE，无需源码。

方法3：自定义脚本注入配置到单文件 #

编写PowerShell/Python脚本自动化以下流程：

• 收集主DLL和所有依赖文件
• 使用dotnet publish生成基础单文件EXE（不带配置）
• 将配置文件注入到EXE的资源段
• 主DLL中通过Win32 API（Windows）或对应平台的资源读取接口获取配置

这种方式灵活性最高，但需要处理平台相关的资源操作逻辑。

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