用途:在带有 Node 前端资产的 .NET 仓库中引入 Biome,用一套工具完成 JS、TS、CSS、JSON、GraphQL、HTML 的格式化、Lint 与导入排序,或评估其替代 ESLint + Prettier 的可行性。
触发条件:仓库存在 biome.json、@biomejs/biome,或用户要求更快的全合一前端格式化与 Lint 方案,或团队正在比较 Biome 与 ESLint + Prettier。
主要能力:格式化、Lint、导入整理;支持通过 biome.json 配置;提供 check 与 --write 命令;支持 --stdin-file-path 处理嵌套配置与 HTML;含 Nursery 规则(需显式启用)。
使用方式:先确定 Biome 的职责范围(主格式化+Lint、仅格式化、或与 ESLint 共存),优先仓库内固定版本安装:npm i -D -E @biomejs/biome;用 npx @biomejs/biome init 生成配置;在 package.json 添加可重复脚本,如 biome check . 与 biome check . --write;迁移时先用 check 和限定目录,再全仓库 --write,之后重跑前端构建与测试。
适用场景:希望简化前端工具链、统一格式化与 Lint、整理导入顺序的 .NET 仓库。
限制:不适用于依赖 Biome 尚未覆盖的 ESLint 插件或框架规则的仓库;不负责运行时站点审计(如 headers、可访问性、SEO,应交给 webhint);若 CSS 或 HTML 已有专门工具且无迁移需求,也不适用。生成资产与第三方代码应在 biome.json 中排除。Biome 与 ESLint 冲突时应明确文件归属,避免在同一范围同时运行。
版本说明:资料提及 Biome CLI 2.5.11 与 2.5.12 的修复与新增规则,升级版本不应视为可擅自更改仓库 Lint 策略。