如何定义List类型环境变量，在C#中读取并覆盖appsettings配置？

在.NET配置系统中，直接用JSON格式的字符串设置环境变量无法被自动解析为列表类型，这是你遇到问题的核心原因。以下是两种可行的解决方法：

方法1：使用索引式环境变量命名 #

针对列表类型的配置项，环境变量需要通过键名+索引的格式逐个定义元素：

• Windows（命令提示符）：

  set MyVariable:0=foo
  set MyVariable:1=bar
  

• Windows（PowerShell）：

  $env:MyVariable:0="foo"
  $env:MyVariable:1="bar"
  

• Linux/macOS（shell不支持冒号，用双下划线替代）：

  export MyVariable__0=foo
  export MyVariable__1=bar
  

配置完成后，执行config.GetSection("MyVariable").Get<List<string>>()即可获取包含["foo", "bar"]的列表。

方法2：启用环境变量的JSON解析（.NET 6及以上版本） #

如果你偏好直接传递JSON字符串，可以在配置构建时开启JSON解析选项：
修改Program.cs中的配置构建代码：

var configuration = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json")
    .AddEnvironmentVariables(options =>
    {
        options.EnableJsonParsing = true; // 开启JSON格式解析
    })
    .Build();

之后就可以直接设置JSON格式的环境变量：

• Windows（命令提示符）：

  set MyVariable=["foo", "bar"]
  

• Windows（PowerShell）：

  $env:MyVariable='["foo", "bar"]'
  

• Linux/macOS：

  export MyVariable='["foo", "bar"]'
  

此时调用Get<List<string>>()就能正确解析出目标列表。

问题根源说明 #

默认情况下，AddEnvironmentVariables()不会自动解析JSON格式的字符串值，你设置的MyVariable=["foo", "bar"]会被视为单个字符串存储在配置系统中，而非列表结构。因此Get<string>()能读取到该字符串，但Get<List<string>>()因无法匹配列表类型，会回退读取appsettings.json中的原始配置值。

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