copy-webpack-plugin 项目中的 glob 模式优化实践

背景介绍

copy-webpack-plugin 作为 Webpack 生态中重要的文件复制插件，在处理文件匹配时长期依赖 globby 库。随着项目发展，团队开始评估更轻量级的替代方案 tinyglobby，这一转变不仅涉及技术选型变更，还带来了 glob 模式匹配行为的规范化调整。

技术选型变迁

globby 作为功能丰富的 glob 模式匹配库，长期以来是 Node.js 生态中的主流选择。然而其依赖链较为复杂，包含 23 个依赖项，这在现代前端追求轻量化的趋势下显得不够理想。相比之下，tinyglobby 仅依赖 2 个包，体积更小且性能更优，已被 vite 等知名项目采用。

实现挑战与解决方案

迁移过程中主要面临两个技术难点：

1. API 兼容性问题：globby 的配置选项直接暴露在插件接口中，而 tinyglobby 的选项类型存在差异。这要求必须通过主版本升级来处理这一破坏性变更。

2. 路径匹配行为差异：测试发现 globby 在某些情况下会默认返回绝对路径，而 tinyglobby 需要显式设置 absolute: true 才能获得相同行为。深入分析表明这实际上是 globby 的一个非标准实现，tinyglobby 的行为更符合规范。

用户影响与迁移指南

升级到 v13 后，用户需要注意以下变化：

• glob 忽略模式语法从 **.ts 调整为更标准的 **/*.ts 格式
• 文件复制顺序现在严格遵循 patterns 数组定义的顺序
• 当多个模式匹配到相同文件时，需要使用 force 选项明确处理方式

典型迁移示例：

// 旧版写法
{ globOptions: { ignore: ['**.ts'] } }

// 新版写法
{ globOptions: { ignore: ['**/*.ts'] } }

最佳实践建议

1. 升级后务必检查所有 glob 忽略模式，确保使用标准语法
2. 对于复杂的多模式场景，启用日志输出验证文件匹配结果
3. 考虑添加测试用例验证关键文件的复制行为
4. 当存在文件冲突时，明确使用 force 选项指定处理策略

未来展望

随着 Node.js 原生 glob 支持的完善，未来可能会进一步减少第三方依赖。目前 tinyglobby 的采用已经显著降低了项目的依赖复杂度，为后续优化奠定了良好基础。开发者应当关注 glob 模式的标准实现，避免依赖特定库的非标准行为。