c#如何使用配置文件_c#配置文件快速上手实战教程

配置文件读不到 `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` 注入强类型配置，避免到处传 `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` 改了配置文件不生效？

`IOptionsSnapshot` 确实支持重载，但前提是配置源本身支持热重载。比如 `appsettings.json` 默认开启，而自定义 XML 或数据库配置源需要手动实现 `IChangeToken`。 这里有几个关键点： - 确认 `AddJsonFile(..., reloadOnChange: true)` 的 `reloadOnChange` 参数是 `true`（默认就是 `true`，但显式写出来更稳妥）。 - `IOptionsSnapshot` 每次从 DI 获取新实例，所以必须在每次请求/作用域内重新注入——不能缓存它的实例到静态字段或单例服务里。 - 修改 JSON 后，观察控制台是否打印 `Config file changed` 日志；没有的话，可能是文件系统监听失效（常见于 Docker 容器挂载或 WSL 共享目录）。 配置热重载依赖底层文件系统事件，Windows 上基本稳定，Linux/macOS 容器里得留意 inotify 限制和挂载方式。真要跨平台可靠，还是得靠环境变量或外部配置中心。