Lựa Chọn Framework Kiểm Thử Unit cho .NET: xUnit, NUnit, và MSTest?

Câu hỏi “xUnit, NUnit hay MSTest?” hiếm khi được trả lời bằng tính năng. Cả ba đều chạy test, đều có attribute, đều có fixture. Khác biệt thật nằm ở ba chỗ: runner (VSTest hay Microsoft.Testing.Platform), cách chia sẻ state giữa các test, và giấy phép của thư viện assertion bạn chọn kèm. Năm 2026, cả ba chỗ đều đã thay đổi.

Cập nhật 2026

  • xUnit v3 (package xunit.v3 4.0.2) là dòng mới, không phải bản nâng cấp của xunit 2.9.3. Test project là executable, hỗ trợ MTP, fixture cấp assembly thay đổi.
  • NUnit 5.0.0 dọn bớt API legacy; MSTest 4.5.2 là MTP-first và có runner riêng.
  • Microsoft.Testing.Platform (MTP) là hướng runner của .NET 10 SDK. dotnet test vẫn chạy được VSTest, nhưng project mới nên đi theo MTP.
  • FluentAssertions 8.11 chuyển sang Xceed Community License: miễn phí cho phi thương mại, thương mại cần mua. Shouldly 4.3.0 (BSD) và AwesomeAssertions (fork Apache-2.0) là hai lựa chọn thay thế.

MTP là gì và vì sao nó ảnh hưởng lựa chọn

VSTest là runner cũ: nó nạp assembly test, đọc metadata, chạy test qua adapter. MTP đảo ngược mô hình — project test là một ứng dụng console tự chạy được, tự khai báo test của mình, và SDK chỉ gọi vào nó. Hệ quả trực tiếp:

  • Project test có <OutputType>Exe</OutputType> và có Main do framework sinh. Bạn có thể chạy trực tiếp dotnet run để chạy test.
  • Không cần Microsoft.NET.Test.Sdk cho project MTP thuần. Đây là điểm mà hầu hết bài viết cũ nói sai.
  • Cờ CLI khác nhau: --filter, định dạng TRX, và cách liệt kê test không giống VSTest. Script CI cần được kiểm tra lại khi chuyển.

Trong ba framework, xUnit v3 và MSTest 4 là MTP-native; NUnit 5 chạy được cả hai. Nếu pipeline của bạn còn phụ thuộc VSTest (ví dụ báo cáo trên Azure DevOps cũ), hãy xác nhận trước khi đổi runner — đây là việc của hạ tầng, không phải của framework.

Cài đặt: ba project, ba bộ package

<!-- File: Tests/Tests.csproj (xUnit v3) -->
<PropertyGroup>
  <TargetFramework>net10.0</TargetFramework>
  <OutputType>Exe</OutputType>
  <IsPackable>false</IsPackable>
</PropertyGroup>
<ItemGroup>
  <PackageReference Include="xunit.v3" Version="4.0.2" />
  <PackageReference Include="Shouldly" Version="4.3.0" />
</ItemGroup>

Với NUnit, thay bằng NUnit 5.0.0 và adapter VSTest tương ứng nếu bạn chưa dùng MTP. Với MSTest, dùng MSTest.TestFramework 4.5.2 và adapter/runner đi kèm. Điểm cần nhớ: không trộn xunit 2.x với xunit.v3 — hai dòng package khác nhau, và trộn lại sẽ cho ra test bị bỏ qua một cách im lặng.

Bố cục solution trên .NET 10

Dù chọn framework nào, hãy tách project theo tốc độ chứ không theo tầng kiến trúc:

  • Tests.Unit — không I/O, không container, chạy dưới 10 giây. Đây là bộ test chạy ở mọi lần lưu file và mọi push.
  • Tests.Integration — database, HTTP, message broker; dùng Testcontainers 4.x để mỗi lần chạy có tài nguyên riêng. Chạy ở PR và trên main.
  • Tests.E2E — Playwright 1.64, chạy theo lịch hoặc trước release, không chạy mỗi push.
# chạy đúng một project, không phụ thuộc thứ tự solution
dotnet test Tests/Tests.Unit/Tests.Unit.csproj

# xUnit v3: chạy trực tiếp, bỏ một lớp khởi động
dotnet run --project Tests/Tests.Unit

Đặt TargetFramework, Nullable và các package dùng chung trong Directory.Packages.props để ba project không lệch phiên bản framework test. Lệch phiên bản giữa unit và integration là nguyên nhân âm thầm khiến một project không được phát hiện test.

Cùng một khái niệm, ba cách đặt tên

Khái niệm xUnit v3 NUnit 5 / MSTest 4
Test không tham số [Fact] NUnit: [Test]
MSTest: [TestMethod]
Test có tham số [Theory] + [InlineData] NUnit: [TestCase]
MSTest: [DataRow]
Chạy trước mỗi test Constructor NUnit: [SetUp]
MSTest: [TestInitialize]
Chạy sau mỗi test Dispose / DisposeAsync NUnit: [TearDown]
MSTest: [TestCleanup]
Chạy một lần mỗi class IClassFixture<T> NUnit: [OneTimeSetUp]
MSTest: [ClassInitialize]
Chạy một lần mỗi assembly Assembly fixture NUnit: [SetUpFixture]
MSTest: [AssemblyInitialize]

xUnit không có attribute cho setup: state được tạo trong constructor của test class, và fixture được inject qua constructor. Đây không phải thiếu sót — nó loại bỏ khả năng “quên gọi base.SetUp()”, một lỗi rất thật ở hai framework còn lại. Đổi lại, bạn phải quen với việc đọc constructor để biết test được chuẩn bị thế nào.

Fixture: nơi quyết định tốc độ của bộ test

Fixture là state dùng chung. Dùng sai, bộ test hoặc chậm hoặc flaky. Với xUnit v3:

// File: Tests/Infrastructure/DatabaseFixture.cs
using Xunit;

public sealed class DatabaseFixture : IAsyncLifetime
{
    public string ConnectionString { get; private set; } = "";

    public async ValueTask InitializeAsync()
    {
        ConnectionString = await TestDatabase.StartAsync();
    }

    public async ValueTask DisposeAsync() => await TestDatabase.StopAsync();
}

// File: Tests/Orders/OrderRepositoryTests.cs
public sealed class OrderRepositoryTests(DatabaseFixture db) : IClassFixture<DatabaseFixture>
{
    [Fact]
    public async Task GetById_ReturnsOrder()
    {
        await using var ctx = TestContext.Create(db.ConnectionString);
        var order = await ctx.Orders.SingleAsync(o => o.Id == 42);
        order.Code.ShouldBe("ORD-42");
    }
}

Ba mức chia sẻ, chọn theo phạm vi thật của tài nguyên:

  • Mỗi test — state trong constructor. Rẻ, cô lập, mặc định nên dùng.
  • Mỗi class — IClassFixture<T>. Dùng cho database container, HTTP server, temp directory.
  • Mỗi collection hoặc assembly — ICollectionFixture<T> và assembly fixture của v3. Dùng cho thứ rất đắt (container khởi động 10 giây) và test chỉ đọc.

Với NUnit, tương ứng là [OneTimeSetUp]/[OneTimeTearDown] và [SetUpFixture]; với MSTest là [ClassInitialize]/[AssemblyInitialize]. Lưu ý cả hai framework yêu cầu method static cho cấp class/assembly, còn xUnit dùng instance — chi tiết này hay làm người mới bối rối khi chuyển.

Chạy song song: mặc định khác nhau, và mặc định của xUnit không phải “tất cả”

  • xUnit: chạy song song theo collection, và mỗi class là một collection. Test trong cùng một class chạy tuần tự. Tắt cho một collection bằng [CollectionDefinition(Name = "db", DisableParallelization = true)]; tắt toàn bộ bằng [assembly: CollectionBehavior(DisableTestParallelization = true)].
  • NUnit: mặc định tuần tự. Bật bằng [assembly: Parallelizable(ParallelScope.Fixtures)] kèm [assembly: LevelOfParallelism(4)], hoặc đánh dấu từng test với [Parallelizable(ParallelScope.All)].
  • MSTest: mặc định tuần tự. Bật bằng [assembly: Parallelize(Scope = ExecutionScope.MethodLevel)] trong AssemblyInfo.cs.

Điểm quan trọng hơn cấu hình: chỉ bật song song khi test thật sự độc lập. Test dùng chung một database, một cổng HTTP cố định, hay một file tạm sẽ flaky ngay khi bật — và flaky test tệ hơn test chậm, vì nó dạy cả đội bỏ qua màu đỏ. Nếu bạn cần song song với tài nguyên dùng chung, hãy cấp cho mỗi test một schema hoặc một container riêng (Testcontainers 4.x làm việc này tốt), rồi mới bật.

Assert: API khác nhau, ngữ nghĩa gần nhau

// xUnit v3
Assert.Equal(3, result.Count);
Assert.Throws<ArgumentNullException>(() => service.Calculate(null!));
await Assert.ThrowsAsync<InvalidOperationException>(() => handler.HandleAsync(cmd));

// NUnit 5 — constraint model
Assert.That(result.Count, Is.EqualTo(3));
Assert.That(() => service.Calculate(null!), Throws.ArgumentNullException);

// MSTest 4
Assert.AreEqual(3, result.Count);
Assert.ThrowsExactly<ArgumentNullException>(() => service.Calculate(null!));

Khác biệt đáng chú ý: MSTest 4 dùng Assert.ThrowsExactly<T> khi bạn cần đúng kiểu exception, thay vì chấp nhận cả lớp con. NUnit 5 nghiêng hẳn về constraint model (Assert.That) và đã bỏ nhiều API classic; nếu bạn còn Assert.AreEqual trong code NUnit, hãy coi đó là nợ kỹ thuật cần trả trước khi nâng cấp.

Còn thư viện assertion bên ngoài thì sao? Chúng đáng dùng khi thông điệp lỗi quan trọng hơn cú pháp:

// Shouldly 4.3.0 (BSD-3)
result.Count.ShouldBe(3);
Should.Throw<ArgumentNullException>(() => service.Calculate(null!));

// FluentAssertions 8.11 (Xceed Community License, phi thương mại)
result.Count.Should().Be(3);

Với sản phẩm thương mại, FluentAssertions 8 cần giấy phép trả tiền. Hai lựa chọn miễn phí: Shouldly (ổn định, ít tính năng hơn, thông điệp tốt) và AwesomeAssertions (fork của FluentAssertions, giữ cú pháp .Should(), Apache-2.0). Nếu đội bạn đã quen .Should(), AwesomeAssertions là đường migration rẻ nhất; nếu không, Shouldly đủ cho hầu hết nhu cầu.

dotnet test: ba khác biệt cần kiểm tra trong CI

  • Đường chạy: project MTP không cần Microsoft.NET.Test.Sdk; project VSTest thì cần. Trộn hai kiểu trong một solution thường vẫn chạy, nhưng log và exit code có thể khác.
  • Lọc test: cú pháp --filter của VSTest (FullyQualifiedName~Order) không được MTP hiểu giống hệt. Đừng copy script cũ mà không chạy thử.
  • Báo cáo: TRX vẫn phổ biến, nhưng MTP có định dạng riêng và hỗ trợ trực tiếp một số reporter. Nếu pipeline parse XML, hãy kiểm tra ở staging trước khi merge.

Một chi tiết thực dụng: với xUnit v3, dotnet run --project Tests chạy test mà không cần qua dotnet test. Trong lúc phát triển, vòng lặp này nhanh hơn đáng kể vì bỏ được một lớp khởi động.

Migration: ba ghi chú ngắn

  • xunit 2 → v3: đổi package sang xunit.v3, thêm OutputType=Exe, bỏ adapter VSTest nếu dùng MTP. IAsyncLifetime trả ValueTask, không phải Task — đây là lỗi biên dịch dễ gặp nhất.
  • NUnit 4 → 5: dọn các API classic đã bị bỏ; chuyển sang Assert.That trước khi nâng, để migration là việc cơ học.
  • MSTest 3 → 4: MTP-first, nên kiểm tra runner trước khi đổi; Assert.ThrowsException đã nhường chỗ cho ThrowsExactly/Throws.

Bảng quyết định

Bối cảnh Chọn Vì sao
Dự án mới, đội quen xUnit xUnit v3 4.0.2 MTP-native, fixture rõ ràng, song song theo collection hợp lý
Đang có bộ test NUnit lớn NUnit 5 Giữ nguyên cú pháp, nâng dần; không có lý do kỹ thuật để đổi
Doanh nghiệp chuẩn Microsoft, cần Test Explorer MSTest 4.5.2 Tích hợp VS tốt nhất, MTP-first, ít phụ thuộc bên thứ ba
Cần assertion giàu thông điệp, thương mại Shouldly hoặc AwesomeAssertions Tránh giấy phép Xceed của FluentAssertions 8
Test tích hợp với DB/HTTP Bất kỳ + Testcontainers 4.x Framework không quyết định chất lượng; tài nguyên cô lập mới quyết định

Cạm bẫy

  • Trộn hai dòng package xUnit. Test biên dịch được nhưng không được liệt kê; kiểm tra dotnet test thấy số test giảm bất thường là dấu hiệu.
  • Setup trong base class. Với NUnit/MSTest, quên gọi base.SetUp() làm test chạy trên state rỗng. xUnit tránh được lớp lỗi này bằng constructor.
  • Bật song song trước khi cô lập tài nguyên. Thứ tự đi đúng là: cô lập → bật song song → đo thời gian.
  • Assertion library như một “chuẩn của đội”. Nếu bạn bắt buộc FluentAssertions 8 trong repo thương mại, đó là quyết định pháp lý, không phải style.
  • Đo coverage thay vì đo hành vi. Cả ba framework đều không giúp gì ở đây; coverage cao với assertion yếu vẫn là bộ test vô dụng.

2027

.NET 11 (RC3, GA tháng 11/2026) tiếp tục đẩy MTP thành mặc định; VSTest sẽ còn trong nhiều năm nhưng không còn là đường mới. Dự đoán an toàn: ba framework tiếp tục hội tụ về MTP, khác biệt chủ yếu còn ở cú pháp và fixture. Chọn framework theo cú pháp đội bạn đọc thoải mái nhất, và chọn runner theo hạ tầng CI — hai quyết định độc lập, đừng gộp làm một.

Checklist

  • Chọn framework theo bộ test hiện có; chọn runner (MTP) theo CI. Đừng đổi cả hai trong một PR.
  • Pin xunit.v3 4.0.2 / NUnit 5.0.0 / MSTest 4.5.2 và ghi rõ trong Directory.Packages.props nếu dùng central package management.
  • Fixture theo phạm vi tài nguyên: per-test mặc định, per-class cho DB/HTTP, per-assembly chỉ khi thật đắt.
  • Chỉ bật song song sau khi mỗi test có tài nguyên riêng; ghi lại cấu hình trong AssemblyInfo.cs hoặc xunit.runner.json.
  • Kiểm tra giấy phép assertion library trước khi merge vào sản phẩm thương mại.

Đọc tiếp trong series