使用ConfigurationBuilder读取配置后，如何修改并更新JSON配置文件？

首先明确：.NET 中通过ConfigurationBuilder构建的IConfiguration是只读设计，没有内置的默认方法将修改后的配置值写回JSON文件。

原因 #

IConfiguration的核心定位是加载和读取配置，支持从多种源（JSON、XML、环境变量等）聚合配置，但并未提供反向持久化的能力——因为不同配置源的写入逻辑差异极大，框架无法统一实现通用的写入方案。

解决方法 #

需要手动通过JSON序列化库（比如System.Text.Json或Newtonsoft.Json）将配置数据写入文件，核心步骤如下：

• 将配置数据转换为可序列化的结构（强类型类或字典）
• 序列化结构为格式化的JSON字符串
• 将字符串写入目标配置文件

示例代码（基于System.Text.Json） #

强类型配置场景

先定义对应配置结构的类：

public class AppConfig
{
    public string Key { get; set; }
    // 按需添加其他配置项
}

修改并写回配置：

// 读取现有配置到强类型对象
var appConfig = config.Get<AppConfig>();
// 修改配置值
appConfig.Key = "updatedValue";
// 序列化并写入文件
string jsonContent = JsonSerializer.Serialize(appConfig, new JsonSerializerOptions { WriteIndented = true });
string configFilePath = Path.Combine(appDataPath, "config.json");
File.WriteAllText(configFilePath, jsonContent);

键值对直接操作场景

如果不需要强类型，直接用字典处理：

// 构造包含修改后值的字典
var configDict = new Dictionary<string, string>
{
    ["Key"] = "updatedValue",
    // 保留其他需要的配置项
};
// 序列化并写入
string jsonContent = JsonSerializer.Serialize(configDict, new JsonSerializerOptions { WriteIndented = true });
string configFilePath = Path.Combine(appDataPath, "config.json");
File.WriteAllText(configFilePath, jsonContent);

注意事项 #

• 写入前确保目标目录存在，必要时调用Directory.CreateDirectory(appDataPath)提前创建
• 注意文件读写权限（AppData目录默认对当前用户有写入权限）
• 如果初始化时开启了AddJsonFile的reloadOnChange: true参数，写入文件后配置会自动重新加载；未开启则需调用((IConfigurationRoot)config).Reload()手动刷新

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