mcpField
X
xunit-skill

xunit-skill

github.com/lambdatest测试与质量384213 次安装2 周前更新
代码仓库

关于 xunit-skill

xunit-skill 是编写和运行 C# xUnit.net 测试的参考技能,介绍核心测试模式、断言、共享夹具和清理,并提供调试与 CI/CD 指南。

主要功能

  1. 01Fact 与参数化 Theory 测试
  2. 02常用断言模式
  3. 03使用 IClassFixture 共享上下文
  4. 04每项测试的初始化与清理
  5. 05进阶模式与调试参考

适用场景

  1. 01为 C# 方法编写参数化测试
  2. 02在多个测试类间共享数据库上下文
  3. 03确保每项测试清理所用资源
  4. 04使用 dotnet test 运行或筛选测试

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/lambdatest/agent-skills --skill xunit-skill

安装后在 Claude Code 中输入/xunit-skill确认已加载。

附带文件reference/advanced-patterns.mdreference/playbook.md

详细介绍

xUnit.net 测试技能

核心模式

基本测试
using Xunit;

public class CalculatorTests
{
    private readonly Calculator _calc = new();

    [Fact]
    public void Add_TwoPositiveNumbers_ReturnsSum()
    {
        Assert.Equal(5, _calc.Add(2, 3));
    }

    [Fact]
    public void Divide_ByZero_ThrowsException()
    {
        Assert.Throws<DivideByZeroException>(() => _calc.Divide(10, 0));
    }
}
理论(参数化)
[Theory]
[InlineData(2, 3, 5)]
[InlineData(-1, 1, 0)]
[InlineData(0, 0, 0)]
public void Add_ReturnsCorrectSum(int a, int b, int expected)
{
    Assert.Equal(expected, _calc.Add(a, b));
}

[Theory]
[MemberData(nameof(GetTestData))]
public void Add_WithMemberData(int a, int b, int expected)
{
    Assert.Equal(expected, _calc.Add(a, b));
}

public static IEnumerable<object[]> GetTestData()
{
    yield return new object[] { 1, 2, 3 };
    yield return new object[] { -1, -1, -2 };
}

[Theory]
[ClassData(typeof(CalculatorTestData))]
public void Add_WithClassData(int a, int b, int expected)
{
    Assert.Equal(expected, _calc.Add(a, b));
}
断言
Assert.Equal(expected, actual);
Assert.NotEqual(unexpected, actual);
Assert.True(condition);
Assert.False(condition);
Assert.Null(obj);
Assert.NotNull(obj);
Assert.Contains("sub", str);
Assert.DoesNotContain("x", str);
Assert.Empty(collection);
Assert.Single(collection);
Assert.Collection(list,
    item => Assert.Equal("first", item),
    item => Assert.Equal("second", item));
Assert.IsType<MyClass>(obj);
var ex = Assert.Throws<ArgumentException>(() => Method());
Assert.Equal("message", ex.Message);
Assert.InRange(value, 1, 10);
共享上下文(IClassFixture)
public class DatabaseFixture : IDisposable
{
    public DbConnection Connection { get; }
    public DatabaseFixture() { Connection = new DbConnection("test"); }
    public void Dispose() { Connection.Close(); }
}

public class UserTests : IClassFixture<DatabaseFixture>
{
    private readonly DatabaseFixture _fixture;
    public UserTests(DatabaseFixture fixture) { _fixture = fixture; }

    [Fact]
    public void GetUser_ReturnsUser()
    {
        var user = _fixture.Connection.Query<User>("SELECT * FROM Users LIMIT 1");
        Assert.NotNull(user);
    }
}
构造函数/Dispose(每个测试的设置)
public class MyTests : IDisposable
{
    private readonly MyService _service;
    public MyTests() { _service = new MyService(); }   // SetUp
    public void Dispose() { _service.Cleanup(); }       // TearDown

    [Fact]
    public void TestSomething() { Assert.True(_service.IsReady); }
}
反模式
错误做法正确做法原因
带参数的 [Fact][Theory] + [InlineData]xUnit 约定
静态状态IClassFixture测试隔离
不实现 IDisposable实现以进行清理资源管理

设置:dotnet add package xunit xunit.runner.visualstudio Microsoft.NET.Test.Sdk

运行:dotnet test 或 dotnet test --filter "FullyQualifiedName~Calculator"

深入模式

有关高级模式、调试指南、CI/CD 集成和最佳实践, 请参阅 reference/playbook.md。

评论

支持 Markdown