关于 xunit-skill
xunit-skill 是编写和运行 C# xUnit.net 测试的参考技能,介绍核心测试模式、断言、共享夹具和清理,并提供调试与 CI/CD 指南。
主要功能
- 01Fact 与参数化 Theory 测试
- 02常用断言模式
- 03使用 IClassFixture 共享上下文
- 04每项测试的初始化与清理
- 05进阶模式与调试参考
适用场景
- 01为 C# 方法编写参数化测试
- 02在多个测试类间共享数据库上下文
- 03确保每项测试清理所用资源
- 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