fstest.mapfs 是 go 語言中用于測試文件 io 操作的內存虛擬文件系統，通過 map 存儲路徑與文件內容，避免真實文件讀寫。1. 它支持創建虛擬文件和目錄結構，如 “hello.txt” 或 “dir1/”；2. 可模擬文件屬性，如權限 mode 和修改時間 modtime；3. 能用于單元測試中驗證文件讀取邏輯，無需依賴真實磁盤；4. 可結合 embed.fs 測試內嵌資源加載邏輯。
在 Go 項目中，測試文件 IO 操作時常常需要避免直接讀寫真實文件系統。這不僅會拖慢測試速度，還可能導致副作用或依賴外部環境。Go 標準庫中的 testing/fstest 提供了一個輕量級的虛擬文件系統實現，非常適合用來模擬文件結構進行單元測試。
什么是 fstest.MapFS
fstest.MapFS 是 testing/fstest 包的核心類型之一，它是一個基于內存的文件系統實現，使用 map 來保存文件路徑和內容。你可以把它理解為一個“假”的文件系統，只存在于內存中，不會對磁盤造成任何影響。
比如：
立即學習“go語言免費學習筆記（深入）”；
fs := fstest.MapFS{ "hello.txt": {Data: []byte("hello world")}, }
這樣就創建了一個包含 hello.txt 文件的虛擬文件系統，文件內容是 “hello world”。
如何用 fstest 測試文件讀取操作
如果你有一個函數是用來讀取指定路徑下的文件內容的，比如：
func ReadFileContent(fs fs.FS, path string) ([]byte, error) { return fs.ReadFile(path) }
你可以傳入 MapFS 實例作為參數，進行測試：
func TestReadFileContent(t *testing.T) { fsys := fstest.MapFS{ "test.txt": {Data: []byte("some content")}, } content, err := ReadFileContent(fsys, "test.txt") if err != nil { t.Fatal(err) } if string(content) != "some content" { t.Fail() } }
這種方式讓你可以完全控制輸入數據，而且不需要創建真實文件，也更容易做邊界測試，比如測試不存在的文件、空文件等。
支持嵌套目錄結構和多種文件屬性
fstest.MapFS 不僅能模擬普通文件，還可以模擬目錄結構，甚至設置文件權限、修改時間等元信息。
例如：
fs := fstest.MapFS{ "dir1/": {Mode: os.ModeDir}, "dir1/file1.txt": {Data: []byte("file1")}, "dir2/file2.json": {Data: []byte(`{"name":"test"}`)}, "empty_file.txt": {Data: []byte("")}, "readme.md": {Data: []byte("# README"), Mode: 0644}, }
上面的例子中：
- 使用 / 結尾表示這是一個目錄。
- 可以設置 Mode（權限）和 ModTime（修改時間）。
- 這些設置會影響像 os.FileInfo 的行為，從而更貼近真實場景。
配合 embed.FS 做更復雜的測試（可選）
雖然 fstest.MapFS 主要用于構造測試數據，但你也可以結合 embed.FS 在測試中驗證是否正確地加載了內嵌資源。比如：
//go:embed testdata/* var testdata embed.FS func TestLoadEmbeddedFiles(t *testing.T) { // 將 embed.FS 轉換為 fs.FS 接口 subFS, err := fs.Sub(testdata, "testdata") if err != nil { t.Fatal(err) } content, _ := ReadFileContent(subFS, "example.txt") // 繼續斷言 }
這種組合方式適合測試那些需要訪問內嵌靜態資源的代碼邏輯。
基本上就這些。fstest 的設計簡潔又實用，特別適合隔離文件 IO 相關的測試邏輯。只要注意構造好虛擬文件結構，再配合接口抽象（如 fs.FS），就能寫出穩定、快速的單元測試。
