dotnet-testing-xunit-project-setup

xUnit 測試專案設定指南

專案結構最佳實踐

建議的解決方案結構

MyProject/
├── src/                          # 主程式碼目錄
│   └── MyProject.Core/
│       ├── MyProject.Core.csproj
│       ├── Calculator.cs
│       ├── Services/
│       └── Models/
├── tests/                        # 測試程式碼目錄
│   └── MyProject.Core.Tests/
│       ├── MyProject.Core.Tests.csproj
│       ├── CalculatorTests.cs
│       ├── Services/
│       └── Models/
└── MyProject.sln

結構原則：

1. src 與 tests 分離：清楚區分生產程式碼與測試程式碼
2. 命名慣例：測試專案名稱為 {主專案名稱}.Tests
3. 目錄對應：測試專案的資料夾結構應對應主專案的結構
4. 一對一映射：每個主專案應有對應的測試專案

建立 xUnit 測試專案

方法一：使用 .NET CLI（推薦）

步驟 1：建立解決方案與專案

# 建立解決方案
dotnet new sln -n MyProject

# 建立主專案（類別庫）
dotnet new classlib -n MyProject.Core -o src/MyProject.Core

# 建立測試專案（xUnit 範本）
dotnet new xunit -n MyProject.Core.Tests -o tests/MyProject.Core.Tests

# 將專案加入解決方案
dotnet sln add src/MyProject.Core/MyProject.Core.csproj
dotnet sln add tests/MyProject.Core.Tests/MyProject.Core.Tests.csproj

# 建立專案參考（測試專案參考主專案）
dotnet add tests/MyProject.Core.Tests/MyProject.Core.Tests.csproj reference src/MyProject.Core/MyProject.Core.csproj

步驟 2：安裝程式碼覆蓋率工具

# 切換到測試專案目錄
cd tests/MyProject.Core.Tests

# 安裝 coverlet.collector（用於收集程式碼覆蓋率）
dotnet add package coverlet.collector

方法二：使用 Visual Studio

1. 建立解決方案

   • File → New → Project
   • 選擇「Blank Solution」
   • 命名為專案名稱

2. 加入主專案

   • 右鍵解決方案 → Add → New Project
   • 選擇「Class Library」
   • 命名為 MyProject.Core

3. 加入測試專案

   • 右鍵解決方案 → Add → New Project
   • 搜尋並選擇「xUnit Test Project」
   • 命名為 MyProject.Core.Tests

4. 設定專案參考

   • 右鍵測試專案 → Add → Project Reference
   • 勾選主專案

xUnit 測試專案的 csproj 設定

標準 xUnit 測試專案 csproj

請參考同目錄下的 templates/xunit-test-project.csproj 範本檔案。

核心相依套件說明：

1. xunit（2.9.3+）

   • xUnit 測試框架的核心套件
   • 提供 [Fact]、[Theory] 等測試屬性
   • 包含 Assert 類別與斷言方法

2. xunit.runner.visualstudio（3.0.0+）

   • Visual Studio Test Explorer 整合
   • 讓測試能在 VS Code、Visual Studio、Rider 中被探索與執行
   • 支援測試結果的即時顯示