古法编程

Everything Claude Code 的 csharp-testing Skill 是专为 .NET/C# 项目打造的测试体系，集成 xUnit、FluentAssertions、Mocking、Testcontainers、WebApplicationFactory 等现代测试工具和模式。它不仅自动规范测试结构、Mock 依赖、集成测试环境，还能提升测试覆盖率和可维护性，显著优化 AI 辅助开发下的测试流程。无论你是新手还是资深开发者，借助该 Skill 可高效实现单元、集成、端到端测试的全流程自动化。

Everything Claude Code C# Testing Skill：xUnit、FluentAssertions、Mocking 与集成测试最佳实践

在 AI 辅助开发逐渐成为主流的今天，测试代码的质量与体系化已成为衡量团队工程能力的核心指标。Everything Claude Code 的 csharp-testing Skill 正是为此而生，它为 C#/.NET 项目提供了一套生产级的自动化测试最佳实践，帮助开发者用最小的人力成本获得最大化的测试收益。本文将详解该 Skill 的应用场景、触发条件、全流程用法、输出示例、与 Agent/Skill 的协作关系，并结合实际项目场景给出操作指南。

1. 这个 Skill 解决了什么问题？

在未使用 csharp-testing Skill 之前，C#/.NET 项目的测试常见痛点包括：

  • 测试结构混乱、命名随意，难以维护
  • Mock 依赖写法不统一，容易遗漏边界场景
  • 集成测试环境搭建繁琐，真实依赖难以模拟
  • 覆盖率、测试数据生成、测试分层等缺乏标准
  • 新成员 onboarding 或 AI 代码生成时，测试模式杂乱无章

而 csharp-testing Skill 通过标准化 xUnit 测试结构、集成 FluentAssertions、Mock 框架（NSubstitute/Moq）、Testcontainers 等工具，实现：

  • 单元测试、集成测试、端到端测试的自动分层与组织
  • Mock 依赖、断言、数据生成模式全自动化
  • 集成测试环境（如数据库、API）快速搭建与销毁
  • 统一 Arrange-Act-Assert 测试结构，提升可读性与维护性
  • 结合 AI Agent，自动生成高质量、覆盖率达标的测试代码

2. 什么时候会自动激活？

csharp-testing Skill 会在以下场景自动触发：

  • 新增或修改 C# 业务代码时，AI 检测到需补充或更新测试
  • 代码审查阶段，Agent 发现测试覆盖率不足或测试反模式
  • 项目初始化或引入新依赖时，自动生成测试基础设施
  • 调试 flaky/慢测试、分析测试失败原因时
  • 通过 TDD Guide Agent 强制测试先行开发流程

3. 使用流程 Step by Step

Step 1：引入 Skill 并初始化测试基础设施

  • 在 ECC 配置或通过 configure-ecc 向导 选择 csharp-testing Skill
  • 自动生成 tests 目录结构，区分 UnitTests/IntegrationTests/TestHelpers
  • 安装 xUnit、FluentAssertions、NSubstitute/Moq、Testcontainers 等依赖

Step 2：编写单元测试（xUnit + FluentAssertions）

  • Skill 自动建议 Arrange-Act-Assert 结构，推荐命名规范（如 Method_ExpectedResult_WhenCondition）
  • 断言统一采用 FluentAssertions，提升可读性
[Fact]
public async Task PlaceOrderAsync_ReturnsSuccess_WhenRequestIsValid()
{
    // Arrange
    var request = new CreateOrderRequest
    {
        CustomerId = "cust-123",
        Items = [new OrderItem("SKU-001", 2, 29.99m)]
    };

    // Act
    var result = await _sut.PlaceOrderAsync(request, CancellationToken.None);

    // Assert
    result.IsSuccess.Should().BeTrue();
    result.Value.Should().NotBeNull();
    result.Value!.CustomerId.Should().Be("cust-123");
}

Step 3：参数化测试与边界用例

  • 推荐用 [Theory] + InlineData 或 MemberData 组织参数化测试，覆盖多种输入
[Theory]
[InlineData("", false)]
[InlineData("user@example.com", true)]
public void IsValidEmail_ReturnsExpected(string email, bool expected)
{
    EmailValidator.IsValid(email).Should().Be(expected);
}

Step 4：依赖 Mock（NSubstitute/Moq）

  • 自动识别依赖接口，生成 Mock 并验证调用
  • 支持异步 Mock、参数断言、调用次数校验
[Fact]
public async Task PlaceOrderAsync_PersistsOrder()
{
    // Arrange
    var request = ValidOrderRequest();

    // Act
    await _sut.PlaceOrderAsync(request, CancellationToken.None);

    // Assert
    await _repository.Received(1).AddAsync(
        Arg.Is<Order>(o => o.CustomerId == request.CustomerId),
        Arg.Any<CancellationToken>());
}

Step 5：集成测试（WebApplicationFactory/Testcontainers）

  • 对 ASP.NET Core 应用，自动生成 WebApplicationFactory 测试基类，支持替换真实数据库为 InMemory 或 Testcontainers
  • 可自动拉起 Postgres/MySQL 等容器，进行真实集成测试
public sealed class OrderApiTests : IClassFixture<WebApplicationFactory<Program>>
{
    private readonly HttpClient _client;

    public OrderApiTests(WebApplicationFactory<Program> factory)
    {
        _client = factory.WithWebHostBuilder(builder =>
        {
            builder.ConfigureServices(services =>
            {
                services.RemoveAll<DbContextOptions<AppDbContext>>();
                services.AddDbContext<AppDbContext>(options =>
                    options.UseInMemoryDatabase("TestDb"));
            });
        }).CreateClient();
    }

    [Fact]
    public async Task GetOrder_Returns404_WhenNotFound()
    {
        var response = await _client.GetAsync($"/api/orders/{Guid.NewGuid()}");
        response.StatusCode.Should().Be(HttpStatusCode.NotFound);
    }
}
  • 使用 Testcontainers 管理数据库等依赖，实现端到端的真实集成测试
public sealed class PostgresOrderRepositoryTests : IAsyncLifetime
{
    private readonly PostgreSqlContainer _postgres = new PostgreSqlBuilder()
        .WithImage("postgres:16-alpine")
        .Build();

    public async Task InitializeAsync() { ... }
    public async Task DisposeAsync() { ... }

    [Fact]
    public async Task AddAsync_PersistsOrder()
    {
        // ... 测试数据库持久化
    }
}

Step 6：测试组织与数据构建

  • Skill 自动建议 tests 目录分层、测试数据 Builder、Fixture 组织，便于维护和扩展
tests/
  MyApp.UnitTests/
    Services/OrderServiceTests.cs
  MyApp.IntegrationTests/
    Api/OrderApiTests.cs
  MyApp.TestHelpers/
    Builders/OrderBuilder.cs
  • 支持 Builder 模式生成复杂测试数据，提升可读性和复用性
var order = new OrderBuilder()
    .WithCustomer("cust-vip")
    .WithItem("SKU-PREMIUM", 3, 99.99m)
    .Build();

Step 7：运行与调试

  • Skill 提供标准化的测试运行命令和过滤方式
dotnet test
dotnet test --collect:"XPlat Code Coverage"
dotnet test --filter "FullyQualifiedName~OrderService"
dotnet watch test --project tests/MyApp.UnitTests/

4. 输出示例

Skill 生成的测试代码结构清晰、命名规范、断言可读，Mock 与集成测试全部自动化，示例输出见上文代码块。

5. 常见配套 Agent 与协作 Skill

更多 Skill 体系与协作模式详见 Everything Claude Code 完全指南。

6. 常见反模式与修正建议

反模式 推荐修正
测试实现细节 只测行为和结果
共享可变状态 每个测试新建实例（xUnit 构造器已支持）
async 测试用 Thread.Sleep 用 Task.Delay 或轮询辅助方法
断言 ToString() 断言具体属性
一个测试多个断言 每个测试只断言一个逻辑结果
测试名描述实现 用“方法_期望结果_条件”命名
忽略 CancellationToken 始终传递并校验取消

FAQ

Q: csharp-testing Skill 能自动生成哪些类型的测试？
A: 可自动生成单元测试、参数化测试、Mock 依赖测试、ASP.NET Core 集成测试（含数据库）、并支持测试数据生成和目录组织。

Q: 如何与 AI 编程助手配合提升测试效率？
A: 通过 Skill 体系，AI 可自动识别需补测代码、生成标准测试、修正反模式，并联动 Reviewer/TDD Agent 实现全流程自动化。

Q: Skill 是否支持 CI/CD 集成与覆盖率统计？
A: 完全支持，Skill 生成的测试可直接接入 dotnet test、覆盖率统计与 watch 模式，适用于本地与 CI/CD 环境。