IOptions注入后为null的最常见原因是未在Program.cs中显式绑定配置节，仅调用AddOptions()不够，必须用Configure<T>()或AddOptions<T>().BindConfiguration()绑定，且配置节名须与JSON完全一致（区分大小写），类及属性需public，禁止在构造函数中访问Value。
IOptionsProgram.cs 里绑定配置节——不是注册了 AddOptions<t>()</t> 就完事，必须显式调用 Configure<t>()</t> 或 AddOptions<t>().BindConfiguration()</t>。
为什么 IOptions 总是 null？
最常见原因：只写了 builder.Services.AddOptions<mysettings>()</mysettings>，却漏掉绑定步骤。DI 容器根本不知道该从哪节配置加载数据。
- 必须用
builder.Services.Configure<mysettings>(builder.Configuration.GetSection("MySettings"))</mysettings>，且节名"MySettings"要和 JSON 中完全一致（区分大小写） -
MySettings类必须是public，所有属性要有public set，不能是只读自动属性（public string Host { get; }不行） - 别在构造函数里直接访问
options.Value——此时配置可能还没加载完成，建议延迟到方法内首次使用时取值 - 如果用了
appsettings.Development.json，确认它被正确加载（AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true)）
IOptions、IOptionsSnapshot、IOptionsMonitor 怎么选？
三者生命周期和热重载行为完全不同，选错会导致配置不更新或内存泄漏。
-
IOptions<t></t>是单例，启动时读一次，改appsettings.json没反应，适合纯静态参数（如应用名称、版本号） -
IOptionsSnapshot<t></t>是 Scoped，在每个 HTTP 请求或作用域内首次访问时读取；启用reloadOnChange: true后支持热重载，Web API 场景最常用 -
IOptionsMonitor<t></t>是 Singleton，持续监听变更、触发回调，还支持命名选项（Get("dev")），适合后台服务、连接池、定时任务等需要响应配置变化的组件
配置绑定静默失败（字段全是默认值）怎么办？
绑定失败通常不抛异常，只留默认值（比如 int 是 0、string 是 null），排查要盯住这几个点：
- JSON 字段名默认按 camelCase 映射（
"host"→Host属性），若用 PascalCase 写 JSON（"Host"），需手动配置ConfigureOptions关闭命名转换 - 数值型字段不能填空字符串或
null，例如"Port": ""或"Port": null会导致绑定跳过，保留0 - 嵌套对象路径要严格匹配，
"Plc:Host"对应public Plc Plc { get; set; }+public class Plc { public string Host { get; set; } } - 数组必须用 JSON 数组格式（
"Ports": ["COM1", "COM2"]），目标类型推荐List<string></string>，避免用string[]（低版本 .NET 不支持）
多实例配置（Named Options）怎么注册和使用？
当同一类型需要多个配置（比如连两个不同 PLC），就得用命名选项。
- 注册时用
Configure<t>("name", ...)</t>，例如：builder.Services.Configure<plcoptions>("plc-a", cfg => cfg.Bind(builder.Configuration.GetSection("PlcA")))</plcoptions> - 注入时不能用
IOptions<plcoptions></plcoptions>，得用IOptionsMonitor<plcoptions></plcoptions>并调用Get("plc-a") - 注意：命名注册后，无名的
IOptions<plcoptions></plcoptions>就无法解析了，除非你同时注册了无名+命名两种 - 命名选项不支持
IOptionsSnapshot<t></t>的Get()方法，必须用IOptionsMonitor<t></t>
真正容易被忽略的是：配置节名大小写、JSON 字段与 C# 属性的映射规则、以及命名选项对注入方式的强制约束——这些地方一错，程序跑起来没报错，但配置就是不对，查起来特别费时间。
