如何在ASP.NET Core的appsettings.json中用密钥/环境变量替换数组内容？

我来给你梳理几种实用的方法，帮你替换ASP.NET Core配置文件里数组的部分内容——不管是敏感的PublishSettings，还是数组里的服务名称这类项，都能搞定。

一、用环境变量直接覆盖数组项属性 #

ASP.NET Core的配置系统天生支持分层环境变量，只要按照数组索引+属性路径的规则命名环境变量，就能精准覆盖appsettings.json里的数组元素。

命名规则 #

数组元素用索引（从0开始）定位，层级之间用双下划线__（Linux/macOS推荐，避免系统解析问题）或者冒号:（Windows支持）分隔。比如：

• 替换第一个Subscription（Production）的PublishSettings：Subscriptions__0__PublishSettings
• 替换第二个Subscription（Test）下Test2环境的第一个DeploymentServiceName：Subscriptions__1__Environments__1__DeploymentServiceNames__0

具体设置方式 #

1. 本地开发时设置

• Windows命令行：

set Subscriptions__0__PublishSettings=<PublishData>NEW_PROD_SECRET</PublishData>

• Linux/macOS终端：

export Subscriptions__0__PublishSettings="<PublishData>NEW_PROD_SECRET</PublishData>"

2. 容器部署（Docker）

在docker run时通过-e参数传递：

docker run -e Subscriptions__0__PublishSettings="<PublishData>NEW_PROD_SECRET</PublishData>" your-app-image:latest

或者在Dockerfile里用ENV指令预定义。

3. 云服务（比如Azure App Service）

直接在应用的“配置”面板里添加环境变量，键填Subscriptions__0__PublishSettings，值填你的敏感内容即可——云服务会自动处理配置优先级，环境变量会覆盖appsettings.json里的原有值。

二、用密钥管理服务存储敏感内容（比如Azure Key Vault） #

如果是生产环境，敏感信息（比如PublishSettings里的SECRET）建议存在密钥管理服务中，避免明文暴露。以Azure Key Vault为例：

步骤1：在Key Vault中创建密钥 #

密钥名称要对应配置路径，注意Key Vault不允许用下划线或冒号，所以用双横杠--代替层级分隔符：

• 对应Subscriptions[0].PublishSettings的密钥名称：Subscriptions--0--PublishSettings
• 密钥值就是你的<PublishData>SECRET</PublishData>内容

步骤2：在ASP.NET Core中加载Key Vault配置 #

在Program.cs中添加Key Vault配置提供者：

var builder = WebApplication.CreateBuilder(args);

// 添加Azure Key Vault支持
builder.Configuration.AddAzureKeyVault(
    new Uri("https://your-key-vault-name.vault.azure.net/"),
    new DefaultAzureCredential());

// 后续构建应用...
var app = builder.Build();

这样启动时，配置系统会自动从Key Vault加载对应密钥，覆盖appsettings.json里的原有配置。

三、自定义配置变换（复杂场景） #

如果需要更灵活的替换逻辑（比如动态修改数组元素、批量替换），可以写个简单的配置变换逻辑：

1. 在启动时加载环境变量或密钥，
2. 手动修改IConfiguration中的对应项。

示例代码：

var builder = WebApplication.CreateBuilder(args);

// 从环境变量获取新的Production PublishSettings
var prodPublishSettings = Environment.GetEnvironmentVariable("ProductionPublishSettings");
if (!string.IsNullOrEmpty(prodPublishSettings))
{
    // 修改配置中的对应项
    builder.Configuration["Subscriptions:0:PublishSettings"] = prodPublishSettings;
}

// 同理可以修改数组中的其他项，比如替换Test2的DeploymentServiceNames
var test2Services = Environment.GetEnvironmentVariable("Test2DeploymentServices");
if (!string.IsNullOrEmpty(test2Services))
{
    // 解析JSON数组并替换
    var services = JsonSerializer.Deserialize<List<string>>(test2Services);
    if (services != null)
    {
        for (int i = 0; i < services.Count; i++)
        {
            builder.Configuration[$"Subscriptions:1:Environments:1:DeploymentServiceNames:{i}"] = services[i];
        }
    }
}

var app = builder.Build();

注意事项 #

• 配置优先级：ASP.NET Core的配置加载顺序是：环境变量 > 密钥管理服务 > appsettings.{Environment}.json > appsettings.json，所以后加载的配置会覆盖前面的。
• 敏感信息保护：永远不要把明文敏感信息提交到代码仓库，优先用环境变量或密钥管理服务。
• 数组索引：数组索引从0开始，要注意对应正确的元素，避免替换错位置。

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