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 的缓存系统紧密集成，确保构建结果的准确性和一致性。

最佳实践建议

1. 使用明确的文件扩展名：避免使用过于宽泛的匹配模式
2. 合理使用排除规则：通过 ! 排除不需要的文件
3. 保持模式简洁：避免过度复杂的嵌套模式

常见问题解答

Q: glob 模式区分大小写吗？ A: 是的，glob 模式是大小写敏感的，这取决于文件系统的支持。

Q: 如何处理隐藏文件？ A: Wireit 的 glob 模式会自动匹配隐藏文件（以点开头的文件）。

通过掌握这些 glob 模式技巧，你将能够充分发挥 Wireit 的构建优化能力，让开发工作流更加顺畅高效！💪