Glob 模式測試器
Glob 模式
路徑
結果
語法速查表
- *
- 單一路徑區段內的任意字元(不符合 /)
- **
- 任意數量的路徑區段,包括零個
- ?
- 恰好一個字元(不含 /)
- [abc]
- 集合中的一個字元;[a-z] 表示範圍,[!abc] 表示反向
- {a,b}
- 候選項,例如 *.{ts,tsx},或範圍如 {1..3}
- !(x)
- 除所列候選項之外的任何內容,例如 !(*.test).ts
- +(x)
- 一個或多個所列候選項,例如 +(a|b)
- @(x)
- 恰好一個所列候選項,例如 @(js|ts)
技術細節
Glob 模式測試器的運作方式
工具的功能
Glob 模式測試器會針對檔案路徑清單檢查一個或多個 glob 模式,並將每個路徑標記為符合或不符合。模式依序以 gitignore 風格評估:以 ! 開頭的模式會從結果中移除路徑,後面的模式會覆蓋前面的模式。每個結果都會顯示最終由哪個模式決定,你還可以檢視 picomatch 為每個模式編譯出的規則運算式。所有操作都在瀏覽器中執行。
常見開發情境
開發者使用 glob 測試器來除錯 tsconfig.json、ESLint 和 Prettier 忽略檔、Jest 和 Vitest 測試模式、GitHub Actions 路徑篩選器、打包工具設定以及 CI 快取鍵中的包含與排除清單。它也適合在提交前檢查 .gitignore 和 .dockerignore 規則,以及弄清楚建置工具為何會選中或悄悄略過某個檔案。
資料格式、類型或變體
預設模式使用 picomatch(micromatch 和許多建置工具背後的比對器),支援 * 和 ** 萬用字元、? 單一字元、[abc] 字元類別、{a,b} 大括號候選項,以及 !(x)、+(x) 和 @(x) 等 extglob。選用的 .gitignore 模式加入了 gitignore 規則:不含斜線的模式可比對任意深度,開頭的斜線表示錨定到根目錄,結尾的斜線僅比對目錄。子目錄中的 .gitignore 檔案,以及「父目錄被排除後其中的檔案無法再被重新納入」的規則不在模擬範圍內。
常見陷阱與最佳實務
除非開啟 dot 選項或明確寫出點,否則萬用字元不會比對點檔案,因此 **/* 會略過 .github 和 .env。* 永遠不會跨越斜線,所以 *.ts 只比對頂層檔案;要比對任意深度請使用 **/*.ts。否定的順序很重要:! 模式只會排除之前模式比對到的路徑。Glob 比對預設區分大小寫,而且不同工具(minimatch、micromatch、shell 萬用字元、.gitignore)之間存在細微差異,因此請在你實際部署所用的工具中確認結果。