.NET6 WinForms是否存在对应.NET Framework的exe.config等效方案？

算力阿峰

2026-8-28

.NET 6 WinForms 没有保留 .NET Framework 时代可视化编辑Settings的设计器入口，但实现完全等效的「部署后直接修改exe.config生效、代码里强类型便捷访问」的功能非常简单，全用内置官方能力就能搞定，不需要引入第三方配置库。

1. 定义配置项

先确认项目里有没有app.config文件：右键项目点「添加」-「新建项」，找「应用程序配置文件」，默认文件名就是app.config，已经有的话直接跳过这步。
打开app.config，在根<configuration>节点下添加<appSettings>节点，所有应用程序级配置都以<add key="配置名" value="配置值"/>的形式写在这个节点下，示例结构：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>
    <add key="ApiAddress" value="http://默认服务端地址"/>
    <add key="SingleFileMaxSize" value="20971520"/>
    <add key="EnableOperationLog" value="false"/>
    <add key="WindowTitle" value="业务管理系统"/>
  </appSettings>
</configuration>

如果要和老版本一样用强类型方式访问，不用等设计器生成代码，自己写个轻量静态类就行，后面访问体验和原来的Properties.Settings.Default几乎没差。

2. 实现编译/部署后可直接编辑配置

这个能力是默认支持的，不需要额外配置：

你在项目里写的app.config，编译时会自动复制到输出目录，自动重命名为[你的程序exe文件名].exe.config，和.NET Framework生成的配置文件命名、路径规则完全一致。
程序部署到目标机器后，直接用文本编辑器打开和exe同目录的这个.exe.config文件，修改对应配置项的value值，保存后重启程序就会加载新配置，不需要重新编译代码。
唯一要注意的点：如果你发布时选了单文件部署模式，记得把app.config的「复制到输出目录」属性设置为「如果较新则复制」，避免配置被打包进单文件exe里，导致部署后找不到可编辑的配置文件。

3. C#代码中访问配置

首先给项目安装官方内置的System.Configuration.ConfigurationManager包：.NET 6把这个和Framework完全兼容的配置API拆成了独立NuGet包，直接在NuGet包管理器里搜名字装最新稳定版就行，没有额外依赖。
不想封装的话可以直接读取，语法和Framework几乎一致：

using System.Configuration;

// 读取字符串配置
string apiAddress = ConfigurationManager.AppSettings["ApiAddress"];
// 其他类型自行转换即可
int maxSize = int.Parse(ConfigurationManager.AppSettings["SingleFileMaxSize"]);
bool enableLog = bool.Parse(ConfigurationManager.AppSettings["EnableOperationLog"]);

想要和老项目一样的便捷访问体验，就把之前说的静态封装类写到项目的Properties文件夹下，示例代码：

using System.Configuration;
using System.Collections.Specialized;

namespace YourAppName.Properties
{
    public static class AppSettings
    {
        private static readonly NameValueCollection _config = ConfigurationManager.AppSettings;

        public static string ApiAddress => _config["ApiAddress"] ?? "http://默认服务端地址";
        public static int SingleFileMaxSize => int.TryParse(_config["SingleFileMaxSize"], out var v) ? v : 20971520;
        public static bool EnableOperationLog => bool.TryParse(_config["EnableOperationLog"], out var v) && v;
        public static string WindowTitle => _config["WindowTitle"] ?? "业务管理系统";
    }
}

封装完之后，在项目任意位置直接用Properties.AppSettings.WindowTitle这种写法就能拿配置，和原来的Properties.Settings.Default.WindowTitle体验完全一致，还自带默认值容错，就算配置文件里漏写了对应项也不会抛空引用异常。

补充：如果是从老.NET Framework项目迁移过来的，原来配置文件里的<applicationSettings>格式节点也能被ConfigurationManager正常识别读取，不用全量改写现有配置内容，只需要自己补上上面的强类型封装类就行，毕竟.NET 6只是去掉了自动生成Settings强类型代码的设计器，底层配置兼容能力是完全保留的。

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