.NET 6 Windows Service能否用app.config.ENV设置环境变量？

基础准备 #

先确保项目里有基础配置和各环境专属配置文件：

• appsettings.json（通用基础配置）
• appsettings.CI.json（CI环境配置）
• appsettings.Production.json（生产环境配置）
• 其他需要的环境配置文件（比如appsettings.Staging.json）

两种实现方式（对标web.config.ENV的效果） #

方式一：启动参数直接指定环境（最简方案） #

和Web应用通过web.config设置环境变量的逻辑对齐，给每个服务实例单独指定环境标识，启动时自动加载对应配置：

1. 创建Windows Service时，在启动命令里添加环境参数：

   sc create "MyService-CI" binPath= "C:\Deploy\MyService.exe --environment CI"
   sc create "MyService-Prod" binPath= "C:\Deploy\MyService.exe --environment Production"
   

2. .NET 6的默认配置加载逻辑会自动识别--environment参数，加载对应的appsettings.{Environment}.json，并和基础配置合并。

方式二：自定义环境配置文件（完全模仿web.config.ENV） #

如果需要像web.config.ENV那样用单独文件管理环境标识，可按以下步骤操作：

1. 为每个环境创建专属的环境配置文件，比如envsettings.CI.json，内容仅定义环境变量：

   {
     "ASPNETCORE_ENVIRONMENT": "CI"
   }
   

2. 修改Program.cs的配置加载逻辑，允许通过参数指定加载这个环境配置文件：

   var builder = Host.CreateDefaultBuilder(args)
       .ConfigureServices((hostContext, services) =>
       {
           services.AddHostedService<Worker>();
       })
       .ConfigureAppConfiguration((hostingContext, config) =>
       {
           // 读取命令行传入的环境配置文件路径
           var envConfigPath = hostingContext.Configuration["envconfig"];
           if (!string.IsNullOrWhiteSpace(envConfigPath))
           {
               config.AddJsonFile(envConfigPath, optional: false, reloadOnChange: true);
           }
       });
   
   builder.Build().Run();
   

3. 创建服务时指定对应的环境配置文件：

   sc create "MyService-CI" binPath= "C:\Deploy\MyService.exe --envconfig envsettings.CI.json"
   sc create "MyService-Prod" binPath= "C:\Deploy\MyService.exe --envconfig envsettings.Production.json"
   

这样每个服务实例会先加载指定的环境配置文件，获取环境标识后再加载对应的appsettings.{Environment}.json，完全复刻web.config.ENV的用法。

验证配置加载（可选） #

在Worker类中添加日志，确认环境和配置是否正确加载：

private readonly ILogger<Worker> _logger;
private readonly IConfiguration _config;

public Worker(ILogger<Worker> logger, IConfiguration config)
{
    _logger = logger;
    _config = config;
}

protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
    while (!stoppingToken.IsCancellationRequested)
    {
        var currentEnv = _config["ASPNETCORE_ENVIRONMENT"];
        var demoSetting = _config["Demo:Value"]; // 对应appsettings.ENV.json里的配置项
        _logger.LogInformation("当前环境: {Env} | 测试配置值: {Value}", currentEnv, demoSetting);
        await Task.Delay(10000, stoppingToken);
    }
}

注意事项 #

• 所有配置文件要和服务exe放在同一目录，或者在命令中指定绝对路径。
• 不要用系统级环境变量指定ASPNETCORE_ENVIRONMENT，否则同一主机上的所有服务会共享这个值，无法实现多环境隔离。
• .NET 6中DOTNET_ENVIRONMENT和ASPNETCORE_ENVIRONMENT都可用于指定环境，前者适用于所有.NET应用，后者针对ASP.NET Core类应用（包括Worker Service）。

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