BiomeJS 2.0 忽略目录配置方法

aixfe2025-09-30 10:19

问题背景

在将 BiomeJS 升级到 2.0 版本后，原有的配置文件中使用了以下配置：

json 复制代码

"files": {
  "ignore": ["proxies", "fonts/*.js"]
}

运行时却报错：Property ignore is not allowed.，打开对应的文件，BiomeJS 插件会显示警告和错误信息。这表明 ignore 字段在 BiomeJS 2.0 中已不再支持。

问题排查

最初尝试通过大语言模型寻求帮助，试图快速修复配置问题，但多次尝试未果。最终决定查阅 BiomeJS 官方文档以寻找解决方案。

通过查阅 BiomeJS 2.0 升级文档，发现了一条关键的 Breaking Change：

Removed include and ignore fields in favor of the new field includes.

文档中提供了一个配置示例：

json 复制代码

"files": {
  "includes": ["**", "!**/*.test.js", "**/special.test.ts", "!test"]
}

这表明，BiomeJS 2.0 使用新的 includes 字段来统一管理文件包含和排除逻辑，支持 glob 模式和否定模式（以 ! 开头）来指定忽略的文件或目录。

解决方案

根据文档示例，将原有配置修改为以下形式：

json 复制代码

"files": {
  "includes": ["**", "!**/proxies/*"]
}

"**": 表示包含所有文件。
"!**/proxies/*": 使用否定模式，排除 proxies 目录下的所有文件。

保存配置后，重新运行 BiomeJS，报错消失，打开对应目录的文件，BiomeJS 插件的错误提示也不显示了，问题成功解决。

总结

BiomeJS 2.0 引入了 includes 字段，取代了原有的 include 和 ignore 字段，用于更灵活地管理文件匹配规则。遇到类似配置问题时，建议直接参考官方文档的 Breaking Changes 部分，并结合提供的示例进行调整。如果大语言模型无法提供准确解决方案，查阅官方文档始终是最可靠的途径。