根本原因是未在中声明节类型，需在顶部用注册，类须继承configurationsection并用[configurationproperty]标记属性。
App.config里加了自定义配置节，但ConfigurationManager.GetSection返回null
根本原因通常是没在<configsections></configsections>里声明节类型。.NET Framework不会自动识别你写的任意XML节点——它必须知道这个节对应哪个类来解析。
实操要点：
- 在
<configuration></configuration>最顶部添加<configsections></configsections>，且必须在<startup></startup>、<appsettings></appsettings>等其他节之前 - 用
<section name="xxx" type="Namespace.ClassName, AssemblyName"></section>注册，注意type值要包含完整类名+程序集名（如MyConfigSection, MyProject） - 自定义节类必须继承
ConfigurationSection，且每个属性需用[ConfigurationProperty]标记 - 如果程序集名含空格或特殊字符，要用引号包裹（但一般建议避免）
写一个能被ConfigurationManager加载的自定义节类
这个类不是普通POCO，而是配置系统专用的解析器。它不负责业务逻辑，只负责把XML字段转成对象属性。
关键约束：
- 类必须有无参构造函数
- 每个公开属性必须有
get/set，且用[ConfigurationProperty("xmlAttributeName")]标注（属性名和XML中字段名可不同） - 如果属性是子节（不是简单字符串/数字），类型需继承
ConfigurationElement，并用[ConfigurationCollection]修饰集合属性 - 别忘了在项目中引用
System.Configuration程序集（.NET Framework项目默认有，.NET Core/.NET 5+需额外安装System.Configuration.ConfigurationManagerNuGet包）
示例节定义：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
<section name="databaseSettings" type="MyApp.DatabaseSection, MyApp"></section>
读取时抛出ConfigurationErrorsException：类型找不到或XML格式错
错误信息里通常带“Could not load type”或“Unrecognized element”，说明解析链断在某个环节。
排查顺序：
- 检查
type字符串中的程序集名是否和实际输出的DLL名完全一致（区分大小写，不含.dll后缀） - 确认自定义节类所在程序集已加载——如果是类库，主程序需直接引用该类库，不能只靠间接依赖
- XML中节内容必须严格匹配类定义：多写了未声明的属性、少写了
[ConfigurationProperty]标记的必需属性、值类型不匹配（比如XML写"true"但属性是int）都会触发此异常 - 嵌套节的层级必须和类结构一致，例如
<connectionstrings><add ...></add></connectionstrings>对应ConfigurationElementCollection子类
为什么改了App.config却读不到新值？
因为ConfigurationManager在首次调用时缓存整个配置，后续读取都走内存副本，不重新加载文件。
强制刷新的方法有限且危险：
-
ConfigurationManager.RefreshSection("sectionName")仅对当前节生效，且要求该节支持运行时重载（自定义节默认不支持） - 真正可靠的方案是重启应用，或改用
ExeConfigurationFileMap手动加载文件（适合调试或配置热更新场景） - 更现实的做法：把频繁变动的配置移到
<appsettings></appsettings>或数据库，自定义节只放启动期固定参数
旧版XML配置的本质是静态快照——它设计初衷就不是为热更新服务的。
