WPF配置文件的核心答案：优先用App.config管理全局只读参数，用settings.settings管理用户偏好，敏感项必须加密，多环境参数建议外置为JSON/XML并做热更新。 这套组合能覆盖大多数WPF桌面应用,从单机工具到工控上位机都不会太别扭。
WPF配置文件有哪些类型？先摸清家底再选型
WPF本身没有发明一套专属配置体系，它沿用了.NET的配置能力，同时能读写任意XML、JSON、INI，选型时先看参数归谁管、要不要热更、是否含敏感信息。
App.config与生成的exe.config
App.config是项目里的源文件，编译后不会原样出现在输出目录，而是变成你的程序名.exe.config，例如Demo.Wpf.exe对应Demo.Wpf.exe.config，运行时ConfigurationManager.AppSettings["Key"]读的就是它，它适合数据库连接字符串、服务地址、超时时间、日志级别这类全局参数。
路径确认代码：
var exeConfig = Path.Combine(
AppDomain.CurrentDomain.BaseDirectory,
$"{Assembly.GetEntryAssembly().GetName().Name}.exe.config");
如果你改了App.config但程序没变化，先看看是不是改错了这个exe.config。
settings.settings的用户级与应用程序级
在Visual Studio里右键项目，添加“设置”文件，就会生成Settings.settings和Settings.Designer.cs,它分两种作用域：
- 应用程序级：只读，适合版本号、默认主题、固定接口地址。
- 用户级：可读写，适合窗口位置、最近打开文件、用户偏好。
用户级设置调用Properties.Settings.Default.Save()后，会写到用户目录下的user.config，不是安装目录,这个差异直接影响权限和更新行为。
自定义JSON/XML在.NET 6+ WPF中的位置
.NET 6、.NET 8的WPF项目里，System.Configuration.ConfigurationManager仍可用，但不少团队更愿意用appsettings.json加自定义配置服务，原因是JSON结构灵活，能嵌套数组，也方便和Web API、微服务保持同一种配置习惯，行业共识认为，桌面端配置格式不必追求统一，关键是读写路径、加密策略和热更新机制要清晰。
| 配置类型 | 典型场景 | 读写方式 | 热更新 | 敏感信息 |
|---|---|---|---|---|
| App.config/exe.config | 全局只读参数 | ConfigurationManager |
需RefreshSection |
可加密 |
| settings.settings | 用户偏好 | Properties.Settings | 保存后生效 | 不建议存密钥 |
| 自定义JSON | 多环境、嵌套结构 | 文件流+反序列化 | 容易实现 | 可加密 |
| 资源resx | 固定文案、图标 | ResourceManager | 需重新编译 | 不适合 |
WPF配置文件修改后不生效怎么办？先查这五个地方
这个问题在部署后出现得最多，尤其是安装到Program Files或ClickOnce目录时，别急着重写代码,按下面顺序排查。
生成目录里的exe.config
你改的是项目里的App.config，程序读的是输出目录的exe.config，发布后，exe.config和主程序在一起，若用安装包覆盖，旧配置可能被替换，建议把可变配置放到%ProgramData%或用户目录,安装包只带默认模板。
ConfigurationManager缓存
ConfigurationManager会缓存配置节，外部修改文件后，当前进程不会自动感知,需要调用：
ConfigurationManager.RefreshSection("appSettings");
ConfigurationManager.RefreshSection("connectionStrings");
刷新后再读，值才会更新，注意，刷新只影响当前AppDomain,不是全系统广播。
Properties.Settings.Default.Save()
用户级设置修改后，不调用Save()，程序重启就丢，调用Save()后，值进入user.config，如果读出来还是旧值，检查是否在错误的作用域里读写，应用程序级设置不能通过Default直接改,改了也不会持久化。
安装目录权限与ClickOnce
安装到Program Files时，普通用户对exe.config没有写权限，你试图保存会抛异常，但有些代码把异常吞了，表现就是“改了没反应”，ClickOnce更特殊，更新时会重建目录，解决办法是使用Environment.SpecialFolder.ApplicationData或CommonApplicationData存放可写配置。
多进程与文件锁
工控上位机常有多进程同时读配置，一个进程写文件时，另一个进程可能读到半截内容，建议写临时文件再原子替换，或加FileShare.Read并做重试，多数情况下,加一个文件锁和重试三次就能避开大部分偶发问题。
WPF配置文件app.config和settings.settings哪个好用？
这不是二选一，而是分工问题，问“哪个好用”之前,先问参数属于机器还是人。
app.config更适合全局参数
连接字符串、WCF地址、串口波特率、PLC站号这类参数，通常由管理员或部署人员维护，用户不该随便改，放在app.config里，配合加密和部署脚本,最省心。
settings.settings更适合用户偏好
窗口宽高、列排序、上次登录账号、主题色，这些交给settings.settings，用户改完立即保存，不干扰全局配置，它生成的user.config天然按用户隔离,适合多用户共用一台电脑的场景。
混用时谁覆盖谁
常见做法是：app.config提供默认值和全局开关，settings.settings保存用户覆盖项，读取时先取用户值，没有再用app.config默认值，业内专家指出，配置层级不要超过三层,否则排查问题会变成迷宫。
敏感配置怎么加密，别把连接字符串裸奔
数据库密码、API密钥、License不要明文放任何配置文件。.NET Framework WPF可用ProtectedData.Protect配合DPAPI：
byte[] plain = Encoding.UTF8.GetBytes("Server=.;Database=Demo;User Id=sa;Password=123;");
byte[] cipher = ProtectedData.Protect(plain, null, DataProtectionScope.CurrentUser);
string base64 = Convert.ToBase64String(cipher);
读取时用ProtectedData.Unprotect解密，DPAPI绑定当前Windows用户或机器，换机器或换用户会解不开，部署时需要在目标机器上重新加密一次，若用.NET 6+，也可以把密钥放到环境变量或Windows凭据管理器,配置文件只存引用名。
WPF桌面应用配置文件热更新场景怎么实现
工控、监控、交易终端经常要求不重启程序就切换参数，热更新不是监听文件变化就完事,重点是线程安全和参数边界。
FileSystemWatcher监听与防抖
FileSystemWatcher能监听文件修改，但一次保存可能触发多次事件，加一个防抖定时器，比如300毫秒内只处理最后一次，还要处理文件被占用、被删除、被重命名的情况。
private void OnChanged(object sender, FileSystemEventArgs e)
{
_debounceTimer.Stop();
_debounceTimer.Start();
}
定时器到点后再读文件、解析、校验。
配置变更事件与UI线程
热更新服务解析出新配置后，通过事件通知各模块，WPF里更新绑定属性必须回到UI线程，用Application.Current.Dispatcher.InvokeAsync，不要在工作线程直接改ObservableCollection或依赖属性。
只热更参数，不热更结构
可以热更超时时间、日志级别、报警阈值、轮询周期，不建议热更窗口布局、数据库架构、插件列表，这些结构变化需要重新初始化，强行热更容易留下半初始化状态，设计时把配置项分为“可热更”和“需重启”两组，界面标注清楚,运维就不会乱改。
WPF配置文件相关的开发报价通常受哪些因素影响
如果你准备外包或采购WPF模块，配置管理往往是隐性工作量，报价差异通常不来自界面,而来自配置的复杂度。
报价差异来自这些工作量
- 配置项数量和嵌套层级：几十个平铺键值便宜,树形多环境配置需要设计类结构。
- 加密与权限：DPAPI、证书、凭据管理器、每机器授权,都会增加测试环节。
- 热更新与回滚：监听、防抖、校验、版本号、失败回滚,代码量可能超过主业务。
- 安装包与升级：安装目录权限、ClickOnce、MSI自定义动作、配置迁移。
- 工控协议对接：串口、Modbus、OPC UA的配置文件常涉及点位表,校验规则复杂。
上海WPF外包项目配置文件交付标准
在上海WPF外包项目里，甲方通常要求交付配置模板、字段说明、加密方案、热更新说明和回滚步骤，配置模板要带注释，字段说明要写清类型、默认值、是否可热更，地域本身不决定技术方案，但交付标准往往更细,验收时会检查安装后能否在无管理员权限下保存用户配置。
Q&A：WPF配置文件常见疑问解答
Q1：WPF配置文件可以用JSON吗？
可以。.NET 6+ WPF常用System.Text.Json读写appsettings.json，JSON适合嵌套结构，但要注意文件路径、编码和热更新时的并发读写，若用.NET Framework，可引入Newtonsoft.Json,成熟稳定。
Q2：WPF配置文件放在哪里不会被安装包覆盖？
放在用户目录或%ProgramData%下，用户级配置用Environment.SpecialFolder.ApplicationData，机器级共享配置用CommonApplicationData，安装包只负责生成默认配置，不覆盖已有用户配置,升级时用版本号判断是否迁移。
Q3：WPF配置文件读取速度慢怎么优化？
把配置一次性加载到内存对象，避免每次取值都读文件，文件监听只负责标记“配置已变”，真正解析放到后台线程，对超大点位表，用二进制或分段加载，不要每次全量反序列化，配置对象注册为单例，通过依赖注入传递,减少重复IO。