.NET 進階測試技能總覽

🤖 AI Agent 重要提示

當您（AI Agent）被載入此進階入口 skill 時，請先閱讀以下指引：

📋 本技能的定位

本檔案是「進階測試導航中心」，用於幫助找到正確的進階子技能。

您的任務是

1. •✅ 根據使用者需求匹配對應的進階子技能
2. •✅ 使用 Skill tool 載入具體的子技能
3. •✅ 讓子技能提供專業的整合測試指引

禁止行為

• •❌ 不要在本入口 skill 中直接提供整合測試程式碼
• •❌ 不要在沒有載入子技能的情況下開始實作測試
• •❌ 不要跳過子技能直接提供「一般性」整合測試建議

🎯 快速技能對照表（AI Agent 必讀）

使用者提到的關鍵字 → 應載入的進階子技能

整合測試技能

容器化測試技能

微服務測試技能

框架升級技能

⚠️ 使用流程範例

✅ 正確流程

使用者：請幫我建立 ProductsController 的 API 整合測試

AI：我注意到您需要進行 API 整合測試。根據快速對照表，
    我應該載入 dotnet-testing-advanced-aspnet-integration-testing skill。

    [使用 Skill tool 載入子技能]

AI：現在按照 ASP.NET Core Integration Testing skill 的指引為您建立測試...

❌ 錯誤流程

使用者：請幫我建立 ProductsController 的 API 整合測試

AI：好的，我來寫整合測試...（直接開始寫程式碼，沒有載入子技能）

📚 完整技能清單

如需查看完整的 8 個進階技能清單、詳細決策樹、學習路徑建議，請繼續閱讀本檔案後續內容。

人類開發者參考：如需快速查找，請查看 SKILLS_QUICK_INDEX.md

適用情境

當您需要以下進階測試能力時，我會協助您找到正確的技能：

• •測試完整的 Web API 端點與 HTTP 流程
• •在測試中使用真實的資料庫（容器化）
• •測試 NoSQL 資料庫（MongoDB、Redis 等）
• •測試微服務架構與分散式系統
• •升級測試框架版本（xUnit 2.x → 3.x）
• •遷移到新測試框架（TUnit）
• •建立端到端的整合測試

快速決策樹

我需要哪種進階測試？

情境 1：測試 ASP.NET Core Web API

選項 A - 基礎 API 測試 → dotnet-testing-advanced-aspnet-integration-testing

適合：

• •簡單的 API 端點測試
• •不需要真實資料庫（使用記憶體資料庫）
• •測試路由、模型綁定、HTTP 回應

涵蓋內容：

• •WebApplicationFactory 使用
• •TestServer 設定
• •HTTP 回應驗證
• •記憶體資料庫配置

選項 B - 完整的 WebAPI 流程測試 → dotnet-testing-advanced-webapi-integration-testing

適合：

• •完整的 CRUD API 測試
• •需要測試完整的業務流程
• •需要測試資料準備與清理

涵蓋內容：

• •完整的 GET、POST、PUT、DELETE 測試
• •錯誤處理驗證
• •測試基底類別模式
• •資料準備策略

情境 2：測試需要真實資料庫

選項 A - 關聯式資料庫（SQL Server、PostgreSQL、MySQL） → dotnet-testing-advanced-testcontainers-database

適合：

• •Entity Framework Core 測試
• •Dapper 測試
• •真實資料庫行為驗證
• •需要測試資料庫特定功能（stored procedures、triggers 等）

支援資料庫：

• •SQL Server
• •PostgreSQL
• •MySQL
• •MariaDB

選項 B - NoSQL 資料庫（MongoDB、Redis、Elasticsearch） → dotnet-testing-advanced-testcontainers-nosql

適合：

• •MongoDB 文件操作測試
• •Redis 快取測試
• •Elasticsearch 搜尋測試
• •NoSQL 特有功能測試

支援資料庫：

• •MongoDB
• •Redis
• •Elasticsearch

情境 3：測試微服務架構

→ dotnet-testing-advanced-aspire-testing

適合：

• •.NET Aspire 專案
• •分散式應用測試
• •服務間通訊測試
• •微服務整合測試

涵蓋內容：

• •DistributedApplication 測試
• •服務依賴管理
• •跨服務測試
• •測試容器編排

情境 4：升級或遷移測試框架

選項 A - xUnit 升級（2.x → 3.x） → dotnet-testing-advanced-xunit-upgrade-guide

適合：

• •現有專案使用 xUnit 2.x
• •想升級到 xUnit 3.x
• •了解版本差異

涵蓋內容：

• •重大變更說明
• •升級步驟指引
• •相容性問題處理
• •最佳實踐

選項 B - 遷移到 TUnit（基礎） → dotnet-testing-advanced-tunit-fundamentals

適合：

• •評估是否遷移到 TUnit
• •了解 TUnit 基礎
• •學習 TUnit 與 xUnit 的差異

涵蓋內容：

• •TUnit 核心概念
• •與 xUnit 對比
• •遷移步驟
• •基本使用方式

選項 C - TUnit 進階功能 → dotnet-testing-advanced-tunit-advanced

適合：

• •已使用 TUnit 基礎
• •想深入使用 TUnit 功能
• •需要平行執行、依賴注入等進階特性

涵蓋內容：

• •資料驅動測試
• •依賴注入
• •平行執行控制
• •進階特性

技能分類地圖

1. 整合測試（4 個技能）- Web API 測試

技能詳細說明

aspnet-integration-testing

核心價值：

• •學習 WebApplicationFactory 基礎
• •理解整合測試概念
• •測試 HTTP 端點而不啟動真實伺服器

適合情境：

• •API 端點基礎測試
• •路由驗證
• •中介軟體測試
• •不需要真實資料庫

學習難度：⭐⭐ 中等

前置技能：

• •dotnet-testing-unit-test-fundamentals（必須）
• •dotnet-testing-awesome-assertions-guide（建議）

webapi-integration-testing

核心價值：

• •完整的 API 測試流程
• •測試資料管理策略
• •錯誤處理驗證
• •真實業務場景測試

適合情境：

• •正式專案的 API 測試
• •完整的 CRUD 流程
• •複雜的業務邏輯驗證
• •需要測試資料準備與清理

學習難度：⭐⭐⭐ 中高

前置技能：

• •dotnet-testing-advanced-aspnet-integration-testing（必須）
• •dotnet-testing-nsubstitute-mocking（建議）

testcontainers-database

核心價值：

• •使用真實資料庫測試
• •自動化容器管理
• •測試資料庫特定功能
• •隔離的測試環境

適合情境：

• •EF Core 測試
• •Dapper 測試
• •Stored Procedures 測試
• •資料庫遷移測試

學習難度：⭐⭐⭐ 中高

前置技能：

• •dotnet-testing-unit-test-fundamentals（必須）
• •Docker 基礎知識（必須）

技術需求：

• •Docker Desktop 已安裝
• •WSL2（Windows 環境）

testcontainers-nosql

核心價值：

• •測試 NoSQL 資料庫操作
• •容器化 NoSQL 環境
• •真實資料庫行為驗證

適合情境：

• •MongoDB 文件操作
• •Redis 快取邏輯
• •Elasticsearch 搜尋功能

學習難度：⭐⭐⭐ 中高

前置技能：

• •dotnet-testing-advanced-testcontainers-database（建議）
• •NoSQL 資料庫基礎知識

2. 微服務測試（1 個技能）- 分散式系統

技能詳細說明

aspire-testing

核心價值：

• •測試 .NET Aspire 專案
• •分散式應用整合測試
• •服務依賴管理
• •端到端流程驗證

適合情境：

• •.NET Aspire 微服務專案
• •多服務協作測試
• •服務發現測試
• •分散式追蹤驗證

學習難度：⭐⭐⭐⭐ 高

前置技能：

• •dotnet-testing-advanced-aspnet-integration-testing（必須）
• •dotnet-testing-advanced-testcontainers-database（建議）
• •.NET Aspire 基礎知識（必須）

技術需求：

• •.NET 8+
• •.NET Aspire Workload
• •Docker Desktop

涵蓋內容：

• •DistributedApplication 測試
• •服務間通訊測試
• •依賴服務管理
• •測試容器編排

3. 框架遷移（3 個技能）- 測試框架升級

技能詳細說明

xunit-upgrade-guide

核心價值：

• •了解 xUnit 3.x 新特性
• •處理升級問題
• •遷移步驟指引

適合情境：

• •專案使用 xUnit 2.x
• •想升級到最新版本
• •了解版本差異

學習難度：⭐⭐ 中等

涵蓋內容：

• •重大變更清單
• •套件升級步驟
• •相容性問題處理
• •升級檢查清單

何時升級：

• •需要 xUnit 3.x 新功能
• •.NET 9+ 專案
• •解決已知問題

tunit-fundamentals

核心價值：

• •了解 TUnit 新世代測試框架
• •學習 TUnit 核心概念
• •評估遷移可行性

適合情境：

• •考慮從 xUnit 遷移
• •新專案選擇測試框架
• •了解現代測試框架

學習難度：⭐⭐ 中等

涵蓋內容：

• •TUnit vs xUnit 對比
• •基本測試撰寫
• •屬性與斷言
• •遷移建議

TUnit 優勢：

• •更好的效能
• •原生支援依賴注入
• •更靈活的測試組織
• •現代化的 API 設計

tunit-advanced

核心價值：

• •深入使用 TUnit 進階功能
• •平行執行控制
• •依賴注入整合
• •資料驅動測試

適合情境：

• •已使用 TUnit 基礎
• •需要進階功能
• •大型測試專案

學習難度：⭐⭐⭐ 中高

前置技能：

• •dotnet-testing-advanced-tunit-fundamentals（必須）

涵蓋內容：

• •進階資料驅動測試
• •依賴注入容器
• •測試執行控制
• •自訂測試框架行為

常見任務映射表

任務 1：測試 ASP.NET Core Web API（基礎）

情境：為簡單的 ProductsController 建立整合測試

推薦技能：

• •dotnet-testing-advanced-aspnet-integration-testing

適用條件：

• •簡單的 CRUD API
• •不需要真實資料庫
• •測試基本的 HTTP 端點

實施步驟：

1. •建立 CustomWebApplicationFactory
2. •設定記憶體資料庫
3. •撰寫 GET、POST 測試
4. •使用 FluentAssertions.Web 驗證回應

提示詞範例：

請使用 dotnet-testing-advanced-aspnet-integration-testing skill
為我的 ProductsController 建立整合測試。Controller 有 GetAll 和 GetById 兩個端點。

預期程式碼結構：

public class ProductsControllerTests : IClassFixture<CustomWebApplicationFactory>
{
    private readonly HttpClient _client;

    public ProductsControllerTests(CustomWebApplicationFactory factory)
    {
        _client = factory.CreateClient();
    }

    [Fact]
    public async Task GetAll_ShouldReturnProducts()
    {
        // Act
        var response = await _client.GetAsync("/api/products");

        // Assert
        response.Should().Be200Ok();
        var products = await response.Content.ReadFromJsonAsync<List<Product>>();
        products.Should().NotBeEmpty();
    }
}

任務 2：測試 ASP.NET Core Web API（完整流程）

情境：為 ShippersController 建立完整的 CRUD 測試

推薦技能：

• •dotnet-testing-advanced-webapi-integration-testing

適用條件：

• •完整的 CRUD API
• •需要測試錯誤處理
• •需要測試資料準備與清理

實施步驟：

1. •建立測試基底類別（BaseIntegrationTest）
2. •實作 IAsyncLifetime 進行資料準備/清理
3. •測試所有 CRUD 端點
4. •驗證錯誤處理（404、400、409 等）

提示詞範例：

請使用 dotnet-testing-advanced-webapi-integration-testing skill
為我的 ShippersController 建立完整的 CRUD 測試。需要測試：
- GET /api/shippers（取得所有）
- GET /api/shippers/{id}（取得單一）
- POST /api/shippers（新增）
- PUT /api/shippers/{id}（更新）
- DELETE /api/shippers/{id}（刪除）
並且驗證錯誤情境（如找不到資源）。

預期測試涵蓋：

• •✅ GET 成功回傳資料
• •✅ GET 不存在的 ID 回傳 404
• •✅ POST 新增成功
• •✅ POST 無效資料回傳 400
• •✅ PUT 更新成功
• •✅ PUT 不存在的 ID 回傳 404
• •✅ DELETE 刪除成功
• •✅ DELETE 不存在的 ID 回傳 404

任務 3：測試需要真實資料庫的程式碼（SQL）

情境：測試 OrderRepository（使用 SQL Server）

推薦技能：

• •dotnet-testing-advanced-testcontainers-database

適用條件：

• •使用 EF Core 或 Dapper
• •需要測試真實資料庫行為
• •需要測試資料庫特定功能

實施步驟：

1. •設定 Testcontainers.MsSql
2. •執行資料庫遷移
3. •測試 Repository 方法
4. •每個測試後清理資料

提示詞範例：

請使用 dotnet-testing-advanced-testcontainers-database skill
為我的 OrderRepository 建立測試。Repository 使用 EF Core 連接 SQL Server。
需要測試 GetById、Create、Update、Delete 方法。

預期程式碼結構：

public class OrderRepositoryTests : IAsyncLifetime
{
    private MsSqlContainer _container;
    private OrderDbContext _context;
    private OrderRepository _sut;

    public async Task InitializeAsync()
    {
        // 啟動 SQL Server 容器
        _container = new MsSqlBuilder().Build();
        await _container.StartAsync();

        // 建立 DbContext
        var options = new DbContextOptionsBuilder<OrderDbContext>()
            .UseSqlServer(_container.GetConnectionString())
            .Options;

        _context = new OrderDbContext(options);
        await _context.Database.MigrateAsync();

        _sut = new OrderRepository(_context);
    }

    [Fact]
    public async Task GetById_ExistingOrder_ShouldReturnOrder()
    {
        // Arrange
        var order = new Order { /* ... */ };
        await _context.Orders.AddAsync(order);
        await _context.SaveChangesAsync();

        // Act
        var result = await _sut.GetById(order.Id);

        // Assert
        result.Should().NotBeNull();
        result.Id.Should().Be(order.Id);
    }

    public async Task DisposeAsync()
    {
        await _container.DisposeAsync();
    }
}

任務 4：測試 NoSQL 資料庫（MongoDB、Redis）

情境：測試 CacheService（使用 Redis）

推薦技能：

• •dotnet-testing-advanced-testcontainers-nosql

適用條件：

• •使用 MongoDB、Redis、Elasticsearch
• •需要測試 NoSQL 特定功能

實施步驟：

1. •設定 Testcontainers.Redis
2. •測試快取邏輯
3. •驗證過期時間
4. •測試快取失效

提示詞範例：

請使用 dotnet-testing-advanced-testcontainers-nosql skill
為我的 CacheService 建立測試。Service 使用 Redis 做快取。
需要測試 Set、Get、Remove 以及過期時間。

預期測試涵蓋：

• •✅ Set 成功儲存資料
• •✅ Get 成功取得資料
• •✅ Get 不存在的鍵回傳 null
• •✅ 過期時間正確運作
• •✅ Remove 成功移除資料

任務 5：測試微服務架構（.NET Aspire）

情境：測試 .NET Aspire 微服務專案

推薦技能：

• •dotnet-testing-advanced-aspire-testing

適用條件：

• •使用 .NET Aspire
• •多服務協作
• •分散式應用

實施步驟：

1. •建立 DistributedApplication 測試
2. •設定服務依賴
3. •測試服務間通訊
4. •驗證完整流程

提示詞範例：

請使用 dotnet-testing-advanced-aspire-testing skill
為我的 .NET Aspire 專案建立測試。專案包含 API Service 和 Worker Service。
需要測試兩個服務的協作。

任務 6：升級 xUnit 到 3.x

情境：現有專案使用 xUnit 2.9.x，想升級到 3.x

推薦技能：

• •dotnet-testing-advanced-xunit-upgrade-guide

實施步驟：

1. •了解重大變更
2. •更新套件版本
3. •處理相容性問題
4. •驗證測試執行

提示詞範例：

請使用 dotnet-testing-advanced-xunit-upgrade-guide skill
協助我升級專案中的 xUnit 到 3.x 版本。目前使用 2.9.2。

任務 7：評估是否遷移到 TUnit

情境：考慮從 xUnit 遷移到 TUnit

推薦技能：

1. •dotnet-testing-advanced-tunit-fundamentals（了解基礎）
2. •dotnet-testing-advanced-tunit-advanced（評估進階功能）

實施步驟：

1. •了解 TUnit 與 xUnit 差異
2. •評估遷移成本
3. •試驗性遷移一個測試檔案
4. •決定是否全面遷移

提示詞範例：

請使用 dotnet-testing-advanced-tunit-fundamentals skill
評估是否應將專案從 xUnit 遷移到 TUnit。專案目前有 500+ 測試。

整合測試層級對應

根據專案複雜度，選擇適合的測試策略：

Level 1：簡單的 WebApi 專案

專案特徵：

• •簡單的 CRUD API
• •無外部依賴或使用記憶體實作
• •業務邏輯簡單

推薦技能：

• •dotnet-testing-advanced-aspnet-integration-testing

測試重點：

• •路由驗證
• •模型綁定
• •HTTP 回應
• •基本業務邏輯

範例專案：

• •TodoList API
• •簡單的產品目錄

Level 2：相依 Service 的 WebApi 專案

專案特徵：

• •有業務邏輯層（Services）
• •依賴外部服務（可以 Mock）
• •中等複雜度

推薦技能組合：

1. •dotnet-testing-advanced-aspnet-integration-testing（基礎）
2. •dotnet-testing-nsubstitute-mocking（模擬依賴）

測試策略：

• •使用 NSubstitute 建立 Service stub
• •測試 Controller 與 Service 的互動
• •驗證錯誤處理

範例專案：

• •電商 API（有庫存、訂單服務）
• •CMS 系統

Level 3：完整的 WebApi 專案

專案特徵：

• •複雜的業務邏輯
• •需要真實資料庫
• •可能有外部 API 整合
• •完整的錯誤處理

推薦技能組合：

1. •dotnet-testing-advanced-webapi-integration-testing（完整流程）
2. •dotnet-testing-advanced-testcontainers-database（真實資料庫）
3. •dotnet-testing-advanced-testcontainers-nosql（如有使用 NoSQL）

測試策略：

• •使用 Testcontainers 建立真實資料庫
• •完整的端到端測試
• •測試資料準備與清理
• •驗證所有錯誤情境

範例專案：

• •大型電商平台
• •企業級管理系統
• •SaaS 應用

學習路徑建議

整合測試入門（1 週）

目標：掌握整合測試基礎，能為 Web API 建立測試

Day 1-2：基礎整合測試

技能：dotnet-testing-advanced-aspnet-integration-testing

學習重點：

• •WebApplicationFactory 概念
• •TestServer 使用
• •HTTP 回應驗證
• •記憶體資料庫配置

實作練習：

• •為簡單的 API 建立整合測試
• •測試 GET、POST 端點

Day 3-4：完整 WebAPI 測試

技能：dotnet-testing-advanced-webapi-integration-testing

學習重點：

• •完整 CRUD 測試
• •測試基底類別設計
• •資料準備與清理
• •錯誤處理驗證

實作練習：

• •為完整的 Controller 建立測試
• •實作測試資料管理

Day 5-6：容器化資料庫測試

技能：dotnet-testing-advanced-testcontainers-database

學習重點：

• •Testcontainers 概念
• •SQL Server 容器設定
• •資料庫遷移執行
• •測試隔離

實作練習：

• •為 Repository 建立測試
• •使用真實資料庫

Day 7：NoSQL 資料庫測試

技能：dotnet-testing-advanced-testcontainers-nosql

學習重點：

• •MongoDB 容器設定
• •Redis 容器設定
• •NoSQL 特定測試模式

實作練習：

• •測試 MongoDB Repository
• •測試 Redis Cache Service

微服務測試專精（3-5 天）

前置條件：完成整合測試入門

技能：dotnet-testing-advanced-aspire-testing

學習重點：

• •.NET Aspire 架構理解
• •DistributedApplication 測試
• •服務依賴管理
• •分散式測試策略

實作練習：

• •測試 Aspire 微服務專案
• •驗證服務間通訊

框架遷移路徑（依需求）

xUnit 升級（1-2 天）

技能：dotnet-testing-advanced-xunit-upgrade-guide

學習重點：

• •xUnit 3.x 新特性
• •重大變更處理
• •升級步驟
• •相容性測試

實施步驟：

1. •了解版本差異
2. •更新套件
3. •處理編譯錯誤
4. •驗證測試執行

TUnit 遷移（2-5 天）

基礎（2-3 天） 技能：dotnet-testing-advanced-tunit-fundamentals

學習重點：

• •TUnit 核心概念
• •與 xUnit 對比
• •基本測試撰寫
• •遷移建議

進階（2-3 天） 技能：dotnet-testing-advanced-tunit-advanced

學習重點：

• •資料驅動測試
• •依賴注入
• •平行執行控制
• •進階特性

技能組合建議

根據不同的專案需求，推薦以下技能組合：

組合 1：完整 API 測試專案

適合：建立正式專案的完整測試套件

技能組合：

1. •dotnet-testing-advanced-aspnet-integration-testing（基礎）
2. •dotnet-testing-advanced-testcontainers-database（真實資料庫）
3. •dotnet-testing-advanced-webapi-integration-testing（完整流程）

學習順序：

1. •先學 aspnet-integration-testing 理解基礎
2. •再學 testcontainers-database 掌握資料庫測試
3. •最後學 webapi-integration-testing 整合應用

預期成果：

• •能為 Web API 專案建立完整測試
• •使用真實資料庫驗證行為
• •測試所有 CRUD 端點與錯誤處理

組合 2：微服務測試方案

適合：微服務架構、分散式系統

技能組合：

1. •dotnet-testing-advanced-aspire-testing（核心）
2. •dotnet-testing-advanced-testcontainers-database（資料庫）
3. •dotnet-testing-advanced-testcontainers-nosql（NoSQL）

學習順序：

1. •先學 testcontainers（資料庫測試基礎）
2. •再學 aspire-testing（微服務測試）

預期成果：

• •測試 .NET Aspire 專案
• •驗證服務間通訊
• •使用容器化環境測試

組合 3：框架現代化

適合：測試框架升級或遷移

選項 A：xUnit 升級

技能：

• •dotnet-testing-advanced-xunit-upgrade-guide

適合：

• •現有專案使用 xUnit 2.x
• •想升級到最新版本

選項 B：TUnit 遷移

技能組合：

1. •dotnet-testing-advanced-tunit-fundamentals（基礎）
2. •dotnet-testing-advanced-tunit-advanced（進階）

適合：

• •新專案選擇測試框架
• •考慮從 xUnit 遷移

學習順序：

1. •先學 fundamentals 了解基礎
2. •再學 advanced 掌握進階功能

前置技能要求

學習進階技能前，建議先掌握以下基礎技能（來自 dotnet-testing 基礎技能集）：

必備技能

1. dotnet-testing-unit-test-fundamentals

為什麼必須：

• •整合測試也遵循 3A Pattern
• •FIRST 原則同樣適用
• •需要理解測試基礎概念

2. dotnet-testing-xunit-project-setup

為什麼必須：

• •需要建立測試專案
• •理解專案結構
• •了解套件管理

3. dotnet-testing-awesome-assertions-guide

為什麼必須：

• •整合測試需要驗證 HTTP 回應
• •FluentAssertions.Web 提供強大的 API 斷言
• •提升測試可讀性

推薦技能

1. dotnet-testing-nsubstitute-mocking

為什麼推薦：

• •整合測試中可能需要 Mock 外部服務
• •WebApplicationFactory 需要替換服務

2. dotnet-testing-autofixture-basics

為什麼推薦：

• •快速產生測試資料
• •減少整合測試的樣板程式碼

引導對話範例

以下範例展示 AI 如何與您互動，幫助您選擇正確的進階技能。

範例 1：API 測試需求

您：我想測試 Web API

AI：我會協助您建立 Web API 測試！請先確認您的測試需求：

1. API 複雜度：

• • 簡單的 API（幾個端點）
• • 中型 API（完整的 CRUD）
• • 複雜 API（多層架構、複雜業務邏輯）

2. 資料庫需求：

• • 不需要資料庫
• • 記憶體資料庫即可
• • 需要真實資料庫

3. 資料庫類型（如需要真實資料庫）：

• • SQL Server / PostgreSQL / MySQL
• • MongoDB / Redis / Elasticsearch
• • 兩者都有

請告訴我您的選擇，我會推薦適合的技能組合。

您：中型 API，需要真實的 SQL Server 資料庫

AI：完美！根據您的需求，我推薦以下技能組合：

第一步：學習基礎整合測試（1-2 天） dotnet-testing-advanced-aspnet-integration-testing

• •理解 WebApplicationFactory
• •學習 HTTP 測試基礎

第二步：加入真實資料庫（2 天） dotnet-testing-advanced-testcontainers-database

• •使用 Testcontainers 設定 SQL Server
• •學習資料庫測試隔離

第三步：完整流程測試（2-3 天） dotnet-testing-advanced-webapi-integration-testing

• •實作完整的 CRUD 測試
• •測試資料管理策略
• •錯誤處理驗證

預期成果： 完成後您將能夠為 API 專案建立完整的整合測試套件，使用真實的 SQL Server 資料庫驗證行為。

需要我使用這些 skills 協助您開始嗎？

範例 2：微服務測試

您：我的專案是 .NET Aspire 微服務架構，要怎麼測試？

AI：.NET Aspire 微服務測試需要特殊的方法！我推薦使用 dotnet-testing-advanced-aspire-testing skill。

前置確認：

1. •

   您已安裝 .NET Aspire Workload？

   • •如果沒有：dotnet workload install aspire
2. •

   您的專案有哪些服務？

   • •API Service
   • •Worker Service
   • •其他服務
3. •

   是否使用資料庫？

   • •如果有，我們會搭配 dotnet-testing-advanced-testcontainers-database

測試重點：

• •DistributedApplication 測試
• •服務間通訊驗證
• •依賴服務管理
• •端到端流程測試

需要我使用 dotnet-testing-advanced-aspire-testing skill 協助您建立測試嗎？

範例 3：框架升級

您：我的專案使用 xUnit 2.9，應該升級到 3.x 嗎？

AI：這是個好問題！我會協助您評估。讓我先了解您的情況：

1. 升級動機：

• • 需要 xUnit 3.x 的新功能
• • 解決已知問題
• • 只是想跟上最新版本
• • 其他原因

2. 專案規模：

• • 小型（< 100 個測試）
• • 中型（100-500 個測試）
• • 大型（> 500 個測試）

3. 升級時程壓力：

• • 不急，可以慢慢遷移
• • 需要儘快完成

您：中型專案，主要是想跟上最新版本，不急

AI：了解！我推薦使用 dotnet-testing-advanced-xunit-upgrade-guide skill。

升級計劃：

階段 1：了解差異（1 天）

• •閱讀重大變更清單
• •了解哪些功能受影響
• •評估遷移工作量

階段 2：準備升級（半天）

• •備份目前程式碼
• •更新 .csproj 套件版本
• •檢查編譯錯誤

階段 3：處理相容性（1-2 天）

• •修正編譯錯誤
• •處理執行階段問題
• •驗證所有測試通過

總工時估計：2-3 天

風險評估：⭐⭐ 中低 xUnit 3.x 升級通常很順利，大部分變更都有向後相容。

需要我使用 dotnet-testing-advanced-xunit-upgrade-guide skill 協助您開始升級嗎？

範例 4：TUnit 評估

您：我聽說 TUnit 很不錯，應該遷移嗎？

AI：TUnit 確實是很有潛力的測試框架！讓我協助您評估。

TUnit 主要優勢：

1. •⚡ 更好的效能：平行執行優化
2. •💉 原生依賴注入：不需要額外設定
3. •🎯 現代化 API：更直覺的設計
4. •🔧 靈活性：更多自訂選項

評估重點：

1. 專案狀況：

• •新專案 → 可以考慮直接使用 TUnit
• •現有專案 → 需評估遷移成本

2. 團隊技能：

• •團隊對 xUnit 熟悉度
• •學習新框架的意願

3. 遷移成本：

• •測試數量
• •特殊測試模式（如 Theory、ClassFixture 等）

我的建議：

如果是新專案： 使用 dotnet-testing-advanced-tunit-fundamentals skill 了解 TUnit，考慮直接採用。

如果是現有專案：

1. •先用 dotnet-testing-advanced-tunit-fundamentals 了解基礎
2. •試驗性遷移一個測試檔案
3. •評估實際遷移工作量
4. •決定是否全面遷移

需要我協助您評估嗎？

與基礎技能的關係

進階技能建立在基礎技能之上：

基礎測試能力 → dotnet-testing（基礎技能集）

• •單元測試基礎
• •測試資料生成
• •斷言與模擬
• •特殊場景處理

↓ 進階應用

進階整合測試 → dotnet-testing-advanced（本技能集）

• •Web API 整合測試
• •容器化測試
• •微服務測試
• •框架升級

學習建議： 先完成 dotnet-testing 基礎技能集的核心技能，再進入本進階技能集。

相關資源

原始資料來源

• •

  iThome 鐵人賽系列文章：老派軟體工程師的測試修練 - 30 天挑戰 🏆 2025 iThome 鐵人賽 Software Development 組冠軍

• •

  完整範例程式碼：30Days_in_Testing_Samples 包含所有範例專案的可執行程式碼

技術需求

整合測試技能：

• •.NET 8+
• •Docker Desktop
• •WSL2（Windows 環境）

Aspire 測試技能：

• •.NET 8+
• •.NET Aspire Workload
• •Docker Desktop

下一步

選擇符合您需求的進階技能開始學習，或告訴我您的具體情況，我會推薦最適合的學習路徑！

快速開始：

• •想測試 API → 從 dotnet-testing-advanced-aspnet-integration-testing 開始
• •需要真實資料庫 → 從 dotnet-testing-advanced-testcontainers-database 開始
• •微服務專案 → 使用 dotnet-testing-advanced-aspire-testing
• •框架升級 → 使用對應的升級指南
• •不確定 → 告訴我您的專案情況，我會幫您分析