Wireit glob模式完全指南:文件匹配语法与排除规则详解
Wireit 是一款强大的 npm/pnpm/yarn 脚本升级工具,它通过智能的 glob 模式匹配机制来优化构建流程。掌握 Wireit 的 glob 模式语法,能够让你的构建脚本更加高效和精确。🚀
什么是 Wireit glob 模式?
Wireit 的 glob 模式是一种用于匹配文件和目录路径的模式语法,它允许你使用通配符来批量选择文件。在 wireit.<script> 配置中,files 和 output 属性都使用 glob 模式来指定输入和输出文件。
通过 src/util/glob.ts 模块,Wireit 实现了强大的文件匹配功能,支持多种通配符和排除规则。
基础 glob 语法速查表
以下是 Wireit 支持的 glob 模式语法大全:
| 模式示例 | 功能描述 |
|---|---|
src/**/*.ts | 匹配 src 目录及其所有子目录中的 .ts 文件 |
*.{js,ts} | 匹配当前目录下所有 .js 和 .ts 文件 |
!node_modules | 排除 node_modules 目录及其所有内容 |
config/*.json | 匹配 config 目录下的所有 .json 文件 |
docs | 匹配 docs 目录及其所有递归子目录 |
常用 glob 模式实战技巧
1. 匹配所有 TypeScript 文件
{
"files": ["src/**/*.ts", "tsconfig.json"]
}
这个模式会匹配 src 目录下所有的 TypeScript 文件以及根目录的 tsconfig.json 文件。
2. 排除特定目录
{
"files": ["src/**/*.ts", "!src/test/**"]
}
使用 ! 前缀来排除文件和目录,这在构建时避免不必要的文件处理非常有用。
3. 多文件类型匹配
{
"files": ["src/**/*.{ts,tsx}", "public/**/*.{png,jpg,svg}"]
}
高级 glob 模式配置
跨包文件引用
Wireit 允许在 files 配置中引用其他包的文件:
{
"files": ["../shared/src/**/*.ts"]
}
符号链接处理
在 src/util/glob.ts 中,Wireit 提供了对符号链接的灵活控制选项。
glob 模式的实用场景
增量构建优化
通过精确的 glob 模式配置,Wireit 能够实现智能的增量构建,只重新构建发生变化的文件。
缓存机制集成
glob 模式与 Wireit 的缓存系统紧密集成,确保构建结果的准确性和一致性。
最佳实践建议
- 使用明确的文件扩展名:避免使用过于宽泛的匹配模式
- 合理使用排除规则:通过
!排除不需要的文件 - 保持模式简洁:避免过度复杂的嵌套模式
常见问题解答
Q: glob 模式区分大小写吗? A: 是的,glob 模式是大小写敏感的,这取决于文件系统的支持。
Q: 如何处理隐藏文件? A: Wireit 的 glob 模式会自动匹配隐藏文件(以点开头的文件)。
通过掌握这些 glob 模式技巧,你将能够充分发挥 Wireit 的构建优化能力,让开发工作流更加顺畅高效!💪
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



