在.NET项目中，通过配置文件appsettings.json管理设置；2. 确保文件属性为“始终复制”或“如果较新则复制”；3. 使用IConfiguration接口读取配置，支持索引器和GetSection方法；4. 推荐将配置节绑定到强类型对象，如AppSettings类；5. 在Program.cs中使用services.Configure注册配置；6. 通过IOptions在服务中注入并访问配置值；7. 非DI场景可手动构建ConfigurationBuilder加载JSON文件；8. 支持连接字符串、嵌套配置等常用功能，提升可维护性。
.NET 项目中读取 appsettings.json 配置信息是开发中的常见需求，尤其是在 ASP.NET Core 或 .NET 6+ 的控制台应用中。正确加载和使用配置能提升项目的可维护性和灵活性。
appsettings.json 文件结构
在项目根目录下创建 appsettings.json 文件，内容通常如下：
{
"ConnectionStrings": {
"DefaultConnection": "Server=localhost;Database=MyDb;Trusted_Connection=true;"
},
"AppSettings": {
"SiteName": "My Website",
"PageSize": 10
},
"Logging": {
"LogLevel": {
"Default": "Information"
}
}
}
确保该文件的“复制到输出目录”属性设置为“始终复制”或“如果较新则复制”。
使用 IConfiguration 读取配置
在 .NET 中推荐使用 IConfiguration 接口来读取配置，它由内置依赖注入容器提供。
例如，在 ASP.NET Core 的控制器中使用：
- 通过构造函数注入
IConfiguration - 调用
GetSection或直接用索引器读取值
public class HomeController : Controller
{
private readonly IConfiguration _configuration;
public HomeController(IConfiguration configuration)
{
_configuration = configuration;
}
public IActionResult Index()
{
var siteName = _configuration["AppSettings:SiteName"];
var pageSize = _configuration.GetValuezuojiankuohaophpcnintyoujiankuohaophpcn("AppSettings:PageSize");
return View();
}}
绑定配置到强类型对象
更优雅的方式是将配置节映射为一个 C# 类。
定义类：
public class AppSettings
{
public string SiteName { get; set; }
public int PageSize { get; set; }
}
在 Program.cs 或 Startup.cs 中添加服务：
// 在 Program.cs (.NET 6+)
builder.Services.Configure(builder.Configuration.GetSection("AppSettings"));
然后在需要的地方通过 IOptions 注入：
public class SomeService
{
private readonly AppSettings _appSettings;
public SomeService(IOptionszuojiankuohaophpcnAppSettingsyoujiankuohaophpcn options)
{
_appSettings = options.Value;
}
public void DoWork()
{
Console.WriteLine(_appSettings.SiteName);
}}
在非注入上下文中读取配置
某些场景如静态方法或早期初始化阶段无法使用 DI，可手动构建 ConfigurationBuilder：
var configuration = new ConfigurationBuilder()
.SetBasePath(Directory.GetCurrentDirectory())
.AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
.Build();
var connectionString = configuration.GetConnectionString("DefaultConnection");
var siteName = configuration["AppSettings:SiteName"];
这种方式适合控制台应用或单元测试环境。
基本上就这些。只要配置文件路径正确、结构清晰，并合理使用 IConfiguration 或 IOptions 模式，就能稳定读取 appsettings.json 中的内容。
