.NET Core中如何通过循环加载多目录下的配置文件？

我完全理解你的痛点——逐个指定配置文件名不仅代码冗余，后续新增文件还要改代码，太麻烦了。下面给你分享两种在.NET Core中批量加载多目录配置文件的实用方案，帮你搞定这个问题：

这种方式适合快速上手，直接在Program.cs（.NET 6+顶级语句模式）里写遍历逻辑，把目标目录下的配置文件批量添加到配置构建器中：

var builder = WebApplication.CreateBuilder(args);

// 第一步：定义需要扫描的所有配置目录
var targetConfigDirs = new List<string>
{
    "AppConfigs/FeatureA",
    "AppConfigs/FeatureB",
    "ExternalConfigs/ThirdParty"
};

// 第二步：遍历每个目录，加载所有.json配置文件
foreach (var dirPath in targetConfigDirs)
{
    // 先检查目录是否存在，避免报错
    if (!Directory.Exists(dirPath))
    {
        Console.WriteLine($"配置目录 {dirPath} 不存在，跳过加载");
        continue;
    }

    // 获取目录下所有.json文件（只扫当前目录，不递归子目录）
    var configFiles = Directory.GetFiles(dirPath, "*.json", SearchOption.TopDirectoryOnly);
    
    foreach (var filePath in configFiles)
    {
        // 添加到配置构建器，可选设置：文件不存在不报错、支持热重载
        builder.Configuration.AddJsonFile(filePath, optional: true, reloadOnChange: true);
    }
}

// 后续的服务注册、中间件配置照常进行
var app = builder.Build();

// ... 你的业务代码 ...

小提示： #

• 如果需要递归加载子目录里的配置文件，把SearchOption.TopDirectoryOnly换成SearchOption.AllDirectories即可。
• 如果你的配置文件不是.json格式（比如.ini、.xml），对应替换成AddIniFile、AddXmlFile方法就行，逻辑完全一致。

如果多个项目都需要这个功能，或者想让Program.cs更简洁，可以把遍历逻辑封装成扩展方法，复用性更强：

首先新建一个静态类，写扩展方法：

public static class ConfigurationBuilderExtensions
{
    /// <summary>
    /// 从多个目录批量加载.json配置文件
    /// </summary>
    /// <param name="builder">配置构建器</param>
    /// <param name="directories">要扫描的目录集合</param>
    /// <param name="optional">文件不存在是否不报错</param>
    /// <param name="reloadOnChange">是否支持热重载</param>
    /// <returns>配置构建器（链式调用）</returns>
    public static IConfigurationBuilder AddJsonFilesFromDirectories(
        this IConfigurationBuilder builder, 
        IEnumerable<string> directories, 
        bool optional = true, 
        bool reloadOnChange = true)
    {
        foreach (var dir in directories)
        {
            if (!Directory.Exists(dir))
                continue;

            var jsonFiles = Directory.GetFiles(dir, "*.json", SearchOption.TopDirectoryOnly);
            foreach (var file in jsonFiles)
            {
                builder.AddJsonFile(file, optional, reloadOnChange);
            }
        }
        return builder;
    }
}

然后在Program.cs里直接调用：

var builder = WebApplication.CreateBuilder(args);

// 一行代码搞定批量加载
var configDirs = new[] { "AppConfigs/FeatureA", "AppConfigs/FeatureB" };
builder.Configuration.AddJsonFilesFromDirectories(configDirs);

// ... 后续配置 ...

额外注意事项： #

• 配置文件的加载顺序会影响最终的配置值：后加载的文件会覆盖先加载的同名配置项。如果需要特定顺序，可以在遍历前对目录或文件列表进行排序（比如按文件名排序）。
• 如果是.NET Core 3.x及更早版本（使用Startup.cs模式），逻辑完全一样，把代码放到Startup类的ConfigureServices方法中，通过ConfigurationBuilder或者WebHostBuilder来添加配置即可。

内容的提问来源于stack exchange，提问作者Syed