如何消除VS2022发布的单文件WinForms应用对.dll.config的依赖？

问题核心原因 #

单文件发布时，.NET原生ConfigurationManager默认仍期望从外部.config文件加载配置。即使将App.config设为嵌入式资源，默认配置系统也不会自动读取嵌入式资源，因此单独移动.exe会抛出初始化异常。

以下是三种可行的解决方法：

方法一：自定义嵌入式配置加载逻辑 #

通过代码读取嵌入式的App.config，替换默认配置系统的加载源：

1. 将App.config的Build Action设为Embedded Resource，Copy to Output Directory设为Do not copy。
2. 在程序启动入口（如Program.cs）添加以下代码：

using System.Configuration;
using System.IO;
using System.Reflection;
using System.Xml;

namespace YourAppNamespace
{
    internal static class Program
    {
        [STAThread]
        static void Main()
        {
            InitializeEmbeddedConfig();
            ApplicationConfiguration.Initialize();
            Application.Run(new MainForm());
        }

        private static void InitializeEmbeddedConfig()
        {
            var assembly = Assembly.GetExecutingAssembly();
            // 资源名称格式：项目命名空间.App.config，需替换为你的实际命名空间
            var resourceName = "YourAppNamespace.App.config";

            using (Stream stream = assembly.GetManifestResourceStream(resourceName))
            {
                if (stream == null)
                    throw new FileNotFoundException("嵌入式配置资源未找到", resourceName);

                var xmlDoc = new XmlDocument();
                xmlDoc.Load(stream);

                // 将嵌入式配置写入临时文件供ConfigurationManager加载
                var tempConfigPath = Path.GetTempFileName();
                xmlDoc.Save(tempConfigPath);

                // 映射并加载临时配置文件
                var configMap = new ExeConfigurationFileMap { ExeConfigFilename = tempConfigPath };
                ConfigurationManager.OpenMappedExeConfiguration(configMap, ConfigurationUserLevel.None);

                // 反射重置默认配置状态，确保后续读取使用新配置
                typeof(ConfigurationManager)
                    .GetField("s_initState", BindingFlags.NonPublic | BindingFlags.Static)
                    .SetValue(null, 0);
                typeof(ConfigurationManager)
                    .GetField("s_configSystem", BindingFlags.NonPublic | BindingFlags.Static)
                    .SetValue(null, null);
                typeof(ConfigurationManager)
                    .GetMethod("RefreshSection", BindingFlags.NonPublic | BindingFlags.Static, new[] { typeof(string) })
                    .Invoke(null, new object[] { "appSettings" });
            }
        }
    }
}

方法二：改用JSON配置（推荐） #

完全脱离原生配置系统，用JSON文件存储配置，默认配置嵌入程序，用户修改后的配置保存到用户目录（如AppData）：

1. 添加System.Text.Json或Newtonsoft.Json NuGet包。
2. 创建appsettings.json文件，写入默认配置，设置Build Action为Embedded Resource。
3. 编写配置加载与保存逻辑：

using System.IO;
using System.Reflection;
using System.Text.Json;

namespace YourAppNamespace
{
    public class AppSettings
    {
        public int UserSetting { get; set; } = 0; // 默认值
        // 其他配置项
    }

    internal static class Program
    {
        private static readonly string _settingsSavePath = Path.Combine(
            Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), 
            "YourAppName", "settings.json");
        public static AppSettings CurrentSettings { get; private set; }

        [STAThread]
        static void Main()
        {
            LoadSettings();
            ApplicationConfiguration.Initialize();
            Application.Run(new MainForm());
        }

        private static void LoadSettings()
        {
            // 优先读取用户已保存的配置
            if (File.Exists(_settingsSavePath))
            {
                var json = File.ReadAllText(_settingsSavePath);
                CurrentSettings = JsonSerializer.Deserialize<AppSettings>(json);
            }
            else
            {
                // 读取嵌入式默认配置
                var assembly = Assembly.GetExecutingAssembly();
                var resourceName = "YourAppNamespace.appsettings.json";
                using (Stream stream = assembly.GetManifestResourceStream(resourceName))
                using (StreamReader reader = new StreamReader(stream))
                {
                    var json = reader.ReadToEnd();
                    CurrentSettings = JsonSerializer.Deserialize<AppSettings>(json);
                }
                // 创建保存目录
                Directory.CreateDirectory(Path.GetDirectoryName(_settingsSavePath));
            }
        }

        // 用户修改配置后调用此方法保存
        public static void SaveSettings()
        {
            var json = JsonSerializer.Serialize(CurrentSettings, new JsonSerializerOptions { WriteIndented = true });
            File.WriteAllText(_settingsSavePath, json);
        }
    }
}

这种方式无需依赖外部.config文件，单文件发布后可独立运行，且用户配置会持久化到安全目录。

方法三：将.config嵌入单文件并自动提取 #

通过修改项目配置，将.config嵌入单文件，启动时自动提取到临时目录：

1. 编辑项目文件（.csproj），添加以下配置：

<PropertyGroup>
  <PublishSingleFile>true</PublishSingleFile>
  <IncludeAllContentForSelfExtract>true</IncludeAllContentForSelfExtract>
</PropertyGroup>

<ItemGroup>
  <None Update="App.config">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <EmbeddedResource>true</EmbeddedResource>
  </None>
</ItemGroup>

2. 在启动代码中检查程序目录是否存在.config文件，不存在则从嵌入式资源提取到程序目录或临时目录，再让ConfigurationManager加载。

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