如何运行支持从Visual Studio和Azure DevOps读取配置的XUnit集成测试

采用.NET通用配置系统，按优先级「环境变量 > 本地配置文件」加载参数，测试代码无需感知运行环境，直接读取配置值即可，操作步骤如下：

• 首先给测试项目安装以下NuGet包：
  • Microsoft.Extensions.Configuration.Json
  • Microsoft.Extensions.Configuration.EnvironmentVariables
• 给测试项目添加JSON配置文件appsettings.json，写入本地调试用的默认配置：

{
  "ApiUrl": "https://localhost:5001"
}

• 右键选中appsettings.json→【属性】→【复制到输出目录】选择「如果较新则复制」，确保运行时文件会被输出到执行目录。
• 新增静态配置读取类，统一封装配置加载逻辑：

using Microsoft.Extensions.Configuration;

public static class TestConfiguration
{
    public static string ApiUrl { get; }

    static TestConfiguration()
    {
        IConfigurationRoot config = new ConfigurationBuilder()
            // 加载本地默认配置文件
            .AddJsonFile("appsettings.json", optional: false)
            // 加载环境变量，优先级最高，存在时会覆盖前面的同名配置
            .AddEnvironmentVariables()
            .Build();

        ApiUrl = config.GetValue<string>("ApiUrl");
    }
}

• 测试代码中直接调用TestConfiguration.ApiUrl即可获取对应值，本地Visual Studio/ReSharper运行时会自动读取appsettings.json的默认值，流水线运行时自动读取传入的环境变量值，无需做任何环境判断。

因为配置系统已经支持从环境变量读取参数，只需要在DotNetCoreCLI@2测试任务中把流水线变量映射为环境变量即可，操作步骤如下：

• 先在Azure DevOps流水线中定义ApiUrl变量：可以直接在YAML中定义，也可以在流水线界面的「变量」页中添加（敏感地址建议设置为保密变量）。
• 编写测试任务YAML，通过env字段传入环境变量：

- task: DotNetCoreCLI@2
  displayName: '执行集成测试'
  inputs:
    command: 'test'
    projects: '**/*你的集成测试项目名.csproj'
    arguments: '--configuration Release'
  env:
    # 环境变量名必须和配置读取的键名完全一致
    ApiUrl: $(ApiUrl)

补充说明 #

如果你的配置键是分层结构（比如"IntegrationTest:ApiUrl"），环境变量名需要把冒号替换为双下划线，对应写为IntegrationTest__ApiUrl: $(ApiUrl)，这是.NET配置系统对环境变量键名的兼容规则。
可以提前在本地验证逻辑：打开命令行执行以下命令，确认测试会使用传入的ApiUrl运行：

# PowerShell下设置临时环境变量
$env:ApiUrl = "https://test-api.example.com"
dotnet test

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