ioptions是具生命周期语义的di契约，禁用bind()和手动new；get()用于启动时快照，ioptionsmonitor支持热重载与变更通知，ioptionssnapshot按作用域创建实例；键路径、环境变量分隔符及configurationkeyname特性需严格匹配。
IOptions 不是“教程式配置工具”，它是一套有明确生命周期语义的依赖注入契约。直接调用 Bind() 或手动 new 对象再赋值，绕过了它的设计意图，也埋下了热重载失效、线程安全、作用域错配等隐患。
为什么 Get() 比 Bind() 更常用
Get<t>()</t> 是无状态、一次性快照，适合在启动时读取并缓存（如中间件初始化、服务注册逻辑）；而 Bind() 需要传入一个已实例化的对象，容易误写成单例共享实例，导致后续配置变更不生效。
- 若你只是想把一段配置转成对象（比如解析命令行参数或临时 JSON 片段），用
configuration.GetSection("xxx").Get<myoptions>()</myoptions> - 若你希望该对象能随
appsettings.json文件修改自动更新，必须走IOptionsMonitor<t></t>注入路径，而不是Bind() -
Bind()仅在你需要复用已有对象引用（例如单元测试中 mock 配置容器）时才合理，生产代码中极少需要
IOptionsSnapshot 和 IOptionsMonitor 的关键区别
两者都支持热重载，但触发时机和线程行为不同：
-
IOptionsSnapshot<t></t>：每次请求（HTTP 请求或作用域内）创建一次新实例，适用于有状态中间件或需隔离配置快照的场景；但不响应跨作用域的配置变更（比如后台任务里改了文件，当前作用域已创建的 snapshot 不会变） -
IOptionsMonitor<t></t>：全局单例，内部维护一个最新配置缓存 + 变更通知机制；所有地方拿到的都是同一份实时视图，且可通过OnChange订阅变更事件；适合监听动态开关、限流阈值等运行时可调参数 - 不要在构造函数里依赖
IOptionsMonitor<t></t>的CurrentValue做非幂等操作（比如初始化连接池），因为首次访问可能触发延迟加载，应显式调用CurrentValue或使用Get(string name)明确获取
配置键路径不匹配是最常见的绑定失败原因
JSON 中 "Logging:LogLevel:Default" 必须对应类中 public class Logging { public LogLevelSettings LogLevel { get; set; } } + public class LogLevelSettings { public string Default { get; set; } }，不能靠属性名拼接猜测层级。
- 检查实际加载的键：调用
configuration.AsEnumerable()打印所有键值对，确认是否存在你期望的完整路径（如MyService:TimeoutMs） - 环境变量注入时，双下划线
__才代表层级分隔，MY_SERVICE__TIMEOUT_MS=5000才能映射到MyService.TimeoutMs；单下划线或驼峰命名无效 - 若配置项缺失（如 JSON 里没写
"TimeoutMs"），Get<t>()</t>会用default(int)（即 0），不会报错；需要校验时得额外加if (options.TimeoutMs == 0)类似判断
ConfigurationKeyName 特性只在 GetSection().Get() 路径下生效
[ConfigurationKeyName("connection_string")] 这类特性，仅当通过 Get<t>()</t> 绑定时被 Binder 识别；Bind() 方法完全忽略它。
- 正确用法：
var db = configuration.GetSection("Database").Get<databasesettings>();</databasesettings> - 错误用法：
configuration.GetSection("Database").Bind(dbInstance);—— 此时ConfigurationKeyName不起作用 - 若必须用
Bind()（比如 legacy 测试框架要求），只能靠属性名严格对齐，或自行实现IConfigurationBinder
IOptions<t></t>、IOptionsSnapshot<t></t> 还是 IOptionsMonitor<t></t> —— 这取决于你是否需要响应变更、是否跨作用域共享、以及初始化时机是否允许延迟。选错一个，后面排查热更新不生效或并发读取异常，会花掉比写配置多十倍的时间。
