从 IConfiguration 读取嵌套配置项需用冒号分隔键名（如 "ConnectionStrings:Default"），底层为扁平化存储；GetSection() 或 GetValue() 可直接使用，但要注意类型匹配与空值处理；环境变量需用双下划线 "__" 替代冒号，且优先级高于 appsettings.json；读不到值常因配置源未加载或键名大小写/空格不一致；绑定 POCO 类要求属性名严格匹配配置后缀，不支持驼峰转换。
怎么从 IConfiguration 读取嵌套配置项（比如 ConnectionStrings:Default）
冒号不是路径分隔符的语法糖，而是 IConfiguration 内部用 : 拼接键名的约定。实际存储时，ConnectionStrings:Default 和 ConnectionStrings:Default:Timeout 都是扁平化的字符串键，底层靠冒号分层解析。
直接用 GetSection() 或 GetValue<t>()</t> 都能工作，但要注意类型匹配和空值处理：
-
config.GetValue<int>("Logging:LogLevel:Default")</int>—— 如果键不存在或类型不匹配，会返回default(int)（即0），不会抛异常 -
config.GetSection("ConnectionStrings").GetSection("Default")返回一个新IConfigurationSection，可链式调用GetValue<string>("ConnectionString")</string> - 若配置项是 JSON 格式（如
appsettings.json中的嵌套对象），用Get<t>()</t>映射到 POCO 类更安全，避免手动拼键名出错
环境变量怎么覆盖 appsettings.json 的多层配置
环境变量名必须用双下划线 __ 替代冒号，比如 ConnectionStrings__Default 对应 ConnectionStrings:Default；大小写不敏感，但建议全大写以符合惯例。
常见错误是用了单下划线或横线：ConnectionStrings_Default 或 ConnectionStrings-Default 都不会被识别。
- Windows 命令行设置：
set ConnectionStrings__Default=Server=localhost;Database=test - Linux/macOS：
export ConnectionStrings__Default="Server=localhost;Database=test" - Docker 启动时加
-e ConnectionStrings__Default=...即可生效 - 注意：环境变量优先级高于
appsettings.json，但低于appsettings.{Environment}.json（除非显式禁用）
为什么 config["Logging:LogLevel:Microsoft"] 有时读不到值
不是配置写错了，大概率是 IConfiguration 构建时没加载对应源，或者键名大小写/空格有隐式差异。
ASP.NET Core 默认只加载 appsettings.json 和 appsettings.{Environment}.json，不自动读取 appsettings.Development.json 以外的环境文件——除非你手动调用 AddJsonFile(..., optional: true)。
- 检查
Program.cs中是否漏掉了ConfigureAppConfiguration或AddEnvironmentVariables() -
config["Logging:LogLevel:Microsoft"]实际查的是键Logging:LogLevel:Microsoft，不是logging:loglevel:microsoft（虽然部分源支持小写映射，但不保证） - 用
config.AsEnumerable()打印所有键值对，确认目标键是否存在、拼写是否完全一致
用 Get<t>()</t> 绑定复杂对象时容易忽略的兼容性点
绑定 POCO 类看似简单，但字段命名、嵌套层级、nullability 都会影响结果。它依赖属性名与配置键后缀严格匹配，且不支持自动驼峰转换。
比如配置项是 MyApi:BaseUrl，POCO 必须有 public string BaseUrl { get; set; }，不能写成 baseUrl 或 base_url。
- 类中属性为
string?时，若配置缺失，会设为null；若为string（非空引用类型），缺失时设为空字符串 - 集合类型（如
List<string></string>）需用数组格式配置："Urls": [ "https://a.com", "https://b.com" ] - 不要在绑定类里加构造函数逻辑——
Get<t>()</t>走的是无参构造 + 属性赋值，构造函数不会执行
最麻烦的是深层嵌套 + 可选节组合，比如 Features:Payment:Enabled 存在但 Features:Payment:Gateway 缺失，绑定类里 Gateway 字段可能为 null，但你得自己判断要不要 fallback。
