配置文件读不到 appsettings.json？检查这三处：program.cs 是否调用 configureappconfiguration 或 addjsonfile；appsettings.json 文件属性是否设为“始终复制”；环境变量是否导致加载了 appsettings.{environment}.json 而非主文件。
配置文件读不到 appsettings.json？检查这三处
默认情况下，Program.cs 里没调用 ConfigureAppConfiguration 或漏了 AddJsonFile，配置根本不会加载。.NET 6+ 的模板默认加了，但手动改过启动逻辑（比如用了 IHostBuilder 而非 WebApplicationBuilder）就容易丢。
-
appsettings.json文件属性必须设为「复制到输出目录：始终复制」，否则运行时找不到文件 - 如果用了环境变量（如
ASPNETCORE_ENVIRONMENT=Development），实际加载的是appsettings.Development.json，主文件可能被覆盖或忽略 - 调用
builder.Configuration.GetSection("Logging")前，确保该节点存在且拼写一致——大小写敏感，logging≠Logging
IConfiguration 注入后取值为空？别直接 new 实例
配置对象必须通过 DI 容器获取，自己 new ConfigurationBuilder() 构建的实例和框架内置的不是同一个，取不到 Startup 或 Program 中注册的配置源。
- 在
Program.cs中配置好后，所有服务都应通过构造函数参数接收IConfiguration，而不是自己重建 - 若需在静态方法或工具类中访问配置，改用
IOptions<t></t>注入强类型配置，避免到处传IConfiguration -
GetSection("ConnectionStrings").GetChildren()返回空集合？确认 JSON 中ConnectionStrings是对象而非字符串——"DefaultConnection": "..."才对，不能写成"ConnectionStrings": "..."
连接字符串里带密码，怎么避免明文提交到 Git？
appsettings.json 不适合存敏感信息，哪怕加了 .gitignore，也难保不误提交。.NET 提供更安全的替代路径。
- 开发阶段优先用
user-secrets：执行dotnet user-secrets init+dotnet user-secrets set "ConnectionStrings:Default" "..." - 生产环境走环境变量，比如 Linux 下
export ConnectionStrings__Default="..."（注意双下划线代替冒号） - Azure/AWS 部署时，直接在平台配置应用设置，自动映射为环境变量，无需改代码
- 别在配置文件里写
${PASSWORD}这类占位符——.NET 不解析 shell 变量，会原样当字符串读取
为什么 IOptionsSnapshot<t></t> 改了配置文件不生效？
IOptionsSnapshot 确实支持重载，但前提是配置源本身支持热重载（如 appsettings.json 默认开启，而自定义 XML 或数据库配置源需手动实现 IChangeToken）。
- 确认
AddJsonFile(..., reloadOnChange: true)的reloadOnChange参数是true（默认就是true，但显式写出来更稳妥） -
IOptionsSnapshot每次从 DI 获取新实例，所以必须在每次请求/作用域内重新注入——不能缓存它的实例到静态字段或单例服务里 - 修改 JSON 后，观察控制台是否打印
Config file changed日志；没有的话，可能是文件系统监听失效（常见于 Docker 容器挂载或 WSL 共享目录）
配置热重载依赖底层文件系统事件，Windows 上基本稳定，Linux/macOS 容器里得留意 inotify 限制和挂载方式。真要跨平台可靠，还是得靠环境变量或外部配置中心。
