ASP.NET Core 通过 IConfiguration 统一读取多源配置,依赖注入 + 强类型绑定是推荐方式;默认加载 appsettings.json、环境变量等,Program.cs 中 WebApplicationBuilder.Configuration 开箱即用,服务中应注入 IConfiguration 或 IOptions 而非手动解析。

ASP.NET Core 通过 IConfiguration 接口统一读取各种来源的配置(如 appsettings.json、环境变量、命令行参数等),核心是依赖注入 + 配置绑定,不是手动解析文件。
配置自动注入到 Startup 或 Program 中
在 .NET 6+ 的最小托管模型(Program.cs)中,WebApplicationBuilder.Configuration 就是已预配置好的 IConfiguration 实例,开箱即用:
- 它默认加载
appsettings.json、appsettings.{Environment}.json、环境变量、命令行参数等 - 无需手动创建或调用
ConfigurationBuilder,除非你有特殊需求(比如额外加自定义源)
在服务中使用 IConfiguration(推荐方式)
把 IConfiguration 作为构造函数参数注入,避免静态访问或全局实例:
public class MyService
{
private readonly IConfiguration _config;
public MyService(IConfiguration config)
{
_config = config;
}
public void DoWork()
{
string connStr = _config.GetConnectionString("DefaultConnection");
string apiHost = _config["ApiSettings:Host"]; // 冒号表示层级(对应 JSON 中的嵌套对象)
int timeout = _config.GetValue("ApiSettings:Timeout", 30); // 带默认值
}
}
注意:_config["Section:Key"] 是最轻量的读取方式,适合简单场景;但更推荐类型安全的绑定。
用强类型对象绑定配置(更安全、可测试)
先定义 POCO 类(属性名需与配置键匹配):
public class ApiSettings
{
public string Host { get; set; } = string.Empty;
public int Timeout { get; set; } = 30;
public bool EnableLogging { get; set; }
}
在 Program.cs 中注册绑定:
builder.Services.Configure(builder.Configuration.GetSection("ApiSettings"));
然后在服务中注入 IOptions:
public class MyService
{
private readonly ApiSettings _apiSettings;
public MyService(IOptions options)
{
_apiSettings = options.Value; // 或 IOptionsSnapshot 获取当前快照
}
}
这样支持验证、重载(配合 IOptionsMonitor)、单元测试,也避免硬编码字符串键。
常见配置源和优先级
默认顺序(后加载的覆盖前面同名项):
- appsettings.json
- appsettings.{Environment}.json(如 Development / Production)
- 用户密钥(仅 Development,
dotnet user-secrets) - 环境变量(如
ApiSettings__Host=api.example.com,双下划线代替冒号) - 命令行参数(
--ApiSettings:Host api.example.com)
所有来源最终都合并进同一个 IConfiguration 树,读取方式完全一致。
基本上就这些。不复杂但容易忽略的是:别直接 new ConfigurationBuilder,别用 static ConfigurationManager,坚持依赖注入 + 强类型绑定,配置就既清晰又可靠。










