如何配置.NET Core Xunit项目实现多环境初始化以开展集成测试

刚好你之前在.NET Framework里用多JSON文件的思路完全可以迁移到.NET Core的Xunit项目里，而且还能轻松支持本地和TeamCity的环境切换，我给你一步步拆解怎么做：

1. 先给Xunit项目添加多环境配置文件 #

和ASP.NET Core项目的结构保持一致，在你的Xunit测试项目根目录添加这些文件：

• appsettings.json：基础配置（所有环境通用的设置）
• appsettings.Development.json：开发环境专属配置（本地跑测试时用）
• appsettings.Test.json：测试环境专属配置（TeamCity跑测试时用）
• （如果还有其他环境，比如Staging，继续加对应的appsettings.{EnvironmentName}.json）

比如appsettings.Development.json里可以写开发环境的API地址：

{
  "ApiSettings": {
    "BaseUrl": "http://localhost:5000/api/"
  }
}

appsettings.Test.json里写测试环境的地址：

{
  "ApiSettings": {
    "BaseUrl": "https://test-api.example.com/api/"
  }
}

2. 安装必要的NuGet包 #

要读取这些配置，需要安装几个配置相关的包，在NuGet包管理器里搜索安装：

• Microsoft.Extensions.Configuration
• Microsoft.Extensions.Configuration.Json
• Microsoft.Extensions.Configuration.EnvironmentVariables
• Microsoft.Extensions.Configuration.CommandLine

3. 编写配置加载逻辑 #

在测试项目里新建一个类，比如TestConfig，用来统一加载配置，支持从环境变量或命令行参数切换环境：

using Microsoft.Extensions.Configuration;

public static class TestConfig
{
    public static IConfigurationRoot GetConfiguration()
    {
        var environment = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") ?? "Development";

        var configBuilder = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
            .AddJsonFile($"appsettings.{environment}.json", optional: true, reloadOnChange: true)
            .AddEnvironmentVariables()
            .AddCommandLine(Environment.GetCommandLineArgs());

        return configBuilder.Build();
    }
}

这里的逻辑是：

• 默认用Development环境（本地跑的时候不用额外设置）
• 优先读取环境变量ASPNETCORE_ENVIRONMENT的值，或者命令行传入的--environment参数
• 先加载基础的appsettings.json，再加载对应环境的JSON文件（环境文件的配置会覆盖基础文件的同名项）

4. 本地运行时自动用开发环境 #

要让本地跑测试时默认用开发环境，你可以这样设置：

1. 右键你的Xunit测试项目 → 选择「属性」
2. 切换到「调试」标签页
3. 在「环境变量」区域，添加一个变量：
   • 名称：ASPNETCORE_ENVIRONMENT
   • 值：Development
     这样本地调试或运行测试时，就会自动加载appsettings.Development.json的配置了。

5. TeamCity里指定测试环境 #

在TeamCity的构建步骤中，你有两种方式指定环境：

方式一：通过命令行参数传递 #

在TeamCity的「dotnet test」构建步骤里，把命令行参数改成：

dotnet test --environment Test

这样测试运行时就会加载appsettings.Test.json的配置。

方式二：设置TeamCity的环境变量 #

在TeamCity的构建配置中，添加一个系统环境变量：

• 名称：ASPNETCORE_ENVIRONMENT
• 值：Test
  这样不管你用什么命令跑测试，都会优先使用这个环境变量指定的环境。

6. 在测试类里使用配置 #

最后，在你的Xunit测试类里，就可以轻松获取配置了，比如：

using Xunit;
using Microsoft.Extensions.Configuration;

public class ApiIntegrationTests
{
    private readonly IConfiguration _config;
    private readonly string _apiBaseUrl;

    public ApiIntegrationTests()
    {
        _config = TestConfig.GetConfiguration();
        _apiBaseUrl = _config.GetValue<string>("ApiSettings:BaseUrl");
    }

    [Fact]
    public async Task Get_Api_Endpoint_Returns_Success()
    {
        // 用_apiBaseUrl拼接请求地址，发起API请求
        using var client = new HttpClient();
        var response = await client.GetAsync($"{_apiBaseUrl}users");
        response.EnsureSuccessStatusCode();
    }
}

这样不管是本地跑还是在TeamCity跑，都能自动切换到对应的环境配置，完美衔接你之前在.NET Framework里的习惯！

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