dotnet-testing-filesystem-testing-abstractions

檔案系統測試：使用 System.IO.Abstractions 模擬檔案操作

核心原則

1. 檔案系統相依性的根本問題

傳統直接使用 System.IO 靜態類別的程式碼難以測試，原因包括：

• 速度問題：實際磁碟 IO 比記憶體操作慢 10-100 倍
• 環境相依：測試結果受檔案系統狀態、權限、路徑影響
• 副作用：測試會在磁碟上留下痕跡，影響其他測試
• 並行問題：多個測試同時操作同一檔案會產生競爭條件
• 錯誤模擬困難：難以模擬權限不足、磁碟空間不足等異常

2. System.IO.Abstractions 解決方案

將 System.IO 靜態類別包裝成介面的套件，支援依賴注入和測試替身。

必要 NuGet 套件：

<!-- 正式環境 -->
<PackageReference Include="System.IO.Abstractions" Version="22.1.0" />

<!-- 測試專案 -->
<PackageReference Include="System.IO.Abstractions.TestingHelpers" Version="22.1.0" />

3. 重構步驟

步驟一：將直接使用靜態類別的程式碼改為依賴 IFileSystem

// ❌ 重構前（不可測試）
public class ConfigService
{
    public string LoadConfig(string path) => File.ReadAllText(path);
}

// ✅ 重構後（可測試）
public class ConfigService
{
    private readonly IFileSystem _fileSystem;
    public ConfigService(IFileSystem fileSystem) => _fileSystem = fileSystem;
    public string LoadConfig(string path) => _fileSystem.File.ReadAllText(path);
}

步驟二：在 DI 容器中註冊真實實作

services.AddSingleton<IFileSystem, FileSystem>();

步驟三：在測試中使用 MockFileSystem

var mockFs = new MockFileSystem(new Dictionary<string, MockFileData>
{
    ["config.json"] = new MockFileData("{ \"key\": \"value\" }")
});
var service = new ConfigService(mockFs);

MockFileSystem 測試模式

涵蓋四種核心測試模式：預設檔案狀態建立、驗證寫入結果、目錄操作測試、使用 NSubstitute 模擬 IO 異常（UnauthorizedAccessException 等）。另含進階技巧：串流操作測試、檔案資訊查詢測試、備份檔案測試。

完整 MockFileSystem 測試模式與進階技巧請參考 references/mockfilesystem-patterns.md

最佳實踐

應該這樣做

1. 使用 Path.Combine 處理路徑 — _fileSystem.Path.Combine("configs", "app.json")
2. 防禦性檢查檔案存在性 — 在讀取前先檢查 _fileSystem.File.Exists()
3. 自動建立必要目錄 — 寫入前確保目錄存在
4. 妥善處理各種 IO 異常 — UnauthorizedAccessException、IOException、DirectoryNotFoundException
5. 每個測試使用獨立的 MockFileSystem — 確保測試隔離

應該避免

1. 硬編碼路徑分隔符號 — 使用 Path.Combine 取代 \\ 或 /
2. 在單元測試中使用真實檔案系統 — 使用 MockFileSystem
3. 忽略例外處理 — 不要假設檔案一定存在