一、简介

.NET Core 中配置包含了多个配置提供程序，包括了 appsettings.json、环境变量、命令行参数等，还有一些扩展的自定义提供程序，比如说 ApolloConfig、AgileConfig 这些。有时需要知道一个配置是由哪一个 Provider 执行的，以及配置冲突导致设置没有生效，在 .NET Core 程序中可以使用 ViewConfig 组件来查看调试这些配置。

二、ViewConfig

这里演示使用的是 ASP.NET Core 3.1，只要是 ASP.NET 都支持，因为 AgileConfig 是使用的 .NET standard

2.1 安装 ViewConfig

新建一个项目，从 nuget 安装 ViewConfig package。如下：

2.2 添加 ViewConfig

安装完成以后，需要修改 Startup.cs 文件的 Configure 方法，我们加一行代码 UseViewConfig，这里建议在开发环境中使用。如下：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseViewConfig();
    }   
}

2.3 访问 ViewConfig

然后启动程序，然后访问 /viewconfig 端点，就可以看到 .NET Core 中的配置详细啦。如下

2.4 自定义 ViewConfig

ViewConfig 默认使用的是 /viewconfig 端点，输出的是页面，当然也支持输出 json 和文本。如下：

// 自定义端点
app.UseViewConfig(x => x.Map("/Info")); 

// 页面格式
app.UseViewConfig(x => x.RenderPage()); 

// Json格式
app.UseViewConfig(x => x.Map().RenderJson()); 

// 文本格式
app.UseViewConfig(x => x.Map("/Info").RenderText());

三、总结

ViewConfig 是一个非常简单的组件，可以帮助我们在.NET Core 程序中调试配置信息，需要注意的是，我建议大家只在开发环境中使用它。