ConfigurationManager仅适用于.NET Framework项目，.NET Core/5+须用IConfiguration；AppSettings[key]返回null而非异常，ConnectionStrings[name]需判空再取ConnectionString；自定义节需继承ConfigurationSection并注册；App.config需设Copy to Output Directory，Web.config依赖IIS运行时加载。
ConfigurationManager 是读取 App.config 和 Web.config 最直接的方式，但它在 .NET Core/.NET 5+ 中已被弃用，仅适用于传统 .NET Framework 项目（如 WinForms、WPF、ASP.NET Web Forms、.NET Framework Console）。如果你用的是 .NET Core 或更高版本，请改用 IConfiguration —— 这是根本性差异，不是“写法不同”，而是底层机制完全不同。
读取 appSettings 和 connectionStrings 的最简路径
ConfigurationManager 提供两个静态属性：
-
ConfigurationManager.AppSettings["key"]：获取<appsettings></appsettings>下的字符串值，返回null（不是空串）如果 key 不存在 -
ConfigurationManager.ConnectionStrings["name"]：获取<connectionstrings></connectionstrings>中指定 name 的连接字符串对象，需进一步访问.ConnectionString属性
常见错误现象：
- 直接调用
ToString()而不判空，导致NullReferenceException - 拼错 key 名（XML 区分大小写），返回
null后没处理，下游直接炸 - 在 ASP.NET Core 项目里硬加
System.Configuration引用，编译通过但运行时报ConfigurationErrorsException：“无法识别的配置节”
建议做法：
- 封装一个安全读取函数，比如：
public static string GetAppSetting(string key, string defaultValue = "") { var value = ConfigurationManager.AppSettings[key]; return string.IsNullOrEmpty(value) ? defaultValue : value; } - 对
ConnectionStrings，先检查ConnectionStrings[name]是否为null，再取.ConnectionString - 确保项目已引用
System.Configuration.dll，且目标框架是.NET Framework 4.x（不是.NET Standard或.NET 6+）
读取自定义配置节（如 ）必须手动映射类
ConfigurationManager.GetSection("sectionName") 返回的是 object，不能直接强转，必须提前定义匹配的配置类，并在 <configsections></configsections> 中注册类型。
典型陷阱：
- 忘记在
<configuration></configuration>顶部添加<configsections></configsections>块，运行时抛出异常：“未能识别的配置节” - 配置类中属性名与 XML 属性名不一致（比如 XML 是
logPath，C# 属性写成LogPath），读出来永远是默认值 -
ConfigurationProperty的IsRequired设为true，但 XML 中漏写了该属性，整个节加载失败
关键点：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 自定义节类必须继承
ConfigurationSection - 子元素集合需用
ConfigurationElementCollection，且必须重写CreateNewElement()和GetElementKey() -
GetSection()返回值始终要判空：var section = ConfigurationManager.GetSection("mySettings") as MyConfigSection;
为什么 ConfigurationManager.AppSettings[key] 有时返回 null 却不报错？
因为 AppSettings 是只读字典（KeyValueConfigurationCollection），它内部对不存在的 key 返回 null，而非抛异常。这不是 bug，是设计行为。
影响和应对：
- 它不会触发配置文件语法校验 —— 即使
App.config根本没被复制到输出目录（Copy to Output Directory设为Do not copy），也不会在编译或启动时报错，只会静默返回null - 调试时容易误以为“配置读到了”，实际是空值穿透进业务逻辑
- 推荐在应用启动时集中验证关键配置项是否存在，例如：
if (string.IsNullOrWhiteSpace(GetAppSetting("ApiBaseUrl"))) throw new InvalidOperationException("缺少必需配置：ApiBaseUrl"); - 不要用
?? ""掩盖缺失问题，尤其在连接字符串或路径类配置上
App.config 和 Web.config 的读取行为其实不完全等价
虽然都用 ConfigurationManager，但运行时加载逻辑不同：
-
App.config编译后自动重命名为[AppName].exe.config，并放在输出目录；读取时依赖可执行文件名匹配 -
Web.config由 IIS/ASP.NET 运行时自动加载，支持多层继承（根目录、子目录均可有 web.config），子目录的会合并/覆盖上级配置
容易忽略的细节：
- 在 Web 项目中，
ConfigurationManager.AppSettings读的是当前请求上下文对应的web.config，不是物理路径上的某个文件 - 如果你把
App.config复制到 Web 项目里并试图用ConfigurationManager读它，不会生效 —— 它被忽略 -
Web.config中的<appsettings></appsettings>和<connectionstrings></connectionstrings>可以用同样 API 读，但其他节（如<system.web></system.web>）不能用GetSection直接拿，得走专门 API
真正麻烦的地方不在怎么写代码，而在于：
- 没人告诉你
App.config文件属性里的Copy to Output Directory必须设为Copy always或Copy if newer - 也没人提醒你，发布 Web 项目时，
web.config的transform（如Web.Release.config）是否真起了作用，得看生成后的实际文件内容 - 更隐蔽的是：某些部署环境（如 IIS 的某些托管管道模式）会缓存配置，改了
web.config不重启 AppPool 就不生效
这些不是“高级技巧”，是每天都会卡住人的基础事实。
