结论先行:Biome 用单个 Rust 二进制统一 lint、格式化与 import 整理,一次解析完成三件事,官方宣称与 Prettier 兼容度约 97%;v2 起支持不依赖 tsc 的类型感知 lint 与 monorepo 嵌套配置。新项目值得直接采用,存量项目则要先盘点 ESLint 插件缺口,再决定全量替换还是混合共存。 本文给出配置、迁移与取舍的完整决策依据。
一个工具替代两个意味着什么
ESLint + Prettier 组合的隐性成本不低:两套配置、两次解析、eslint-config-prettier 之类的冲突调和层,以及「lint 过了格式没过」的往返。Biome 的 biome check --write 一条命令完成 lint 修复、格式化与 import 排序,共享同一棵语法树;配置文件只有 biome.json(或 biome.jsonc),不支持 JS 配置。对中小团队,这直接砍掉了一整类「工具链打架」的维护工作。
配置实战
安装时务必精确锁版本(--save-exact),因为格式化结果可能随版本变化:
npm install --save-dev --save-exact @biomejs/biome
npx biome initbiome.json 的关键项:vcs.useIgnoreFile 复用 .gitignore;formatter.indentStyle 显式设为 space(Biome 默认 tab,Prettier 迁移者最易踩坑);linter.rules.recommended 开启推荐规则集;assist.actions.source.organizeImports 接管 import 排序,v2 支持 :NODE:、:PACKAGE:、:ALIAS: 等分组自定义。规则抑制用 biome-ignore 注释且必须附理由,支持文件级与区间级抑制。monorepo 中子包放一份 extends 指向根配置的 biome.json,即可按包放宽或收紧规则。
迁移三步与 CI 接入
第一步,biome migrate eslint --write 自动转换 ESLint 配置(默认不含 inspired 规则,需要时加 --include-inspired);第二步,biome migrate prettier --write 转换格式化选项;第三步,全量跑一次 check --write 并单独提交格式化 diff,避免污染业务评审。CI 中用 biome ci 而非 check:ci 是只读模式,杜绝流水线里意外写文件。Git 钩子用 --staged 只处理暂存文件,Biome 场景下可以不再依赖 lint-staged。大型仓库还可以用 --changed --since=main 只检查相对主干有变更的文件,把门禁耗时进一步压缩;钩子中记得加 --no-errors-on-unmatched,避免暂存区没有匹配文件时误报失败。升级 Biome 大版本后先跑 biome migrate --write 同步配置 schema,再全量格式化一次,保持团队产物一致。
类型感知与 domains
v2 的两个能力值得单独说明。其一是类型感知 lint:Biome 不依赖 TypeScript 编译器,用自研推断引擎实现 noFloatingPromises 等规则,首次运行需要扫描模块图,大仓库首跑会慢一些,后续增量很快;它与 typescript-eslint 的规则覆盖并不完全重合,迁移前要逐条核对团队依赖的类型感知规则。其二是 domains:按技术栈分组的规则集(如 react、test),会根据 package.json 依赖自动推荐开启,替代过去手工挑选插件预设的过程。此外 v2 的 nursery 分组持续孵化新规则,例如近期版本加入的 noConstantComparisons 能抓住 x <= 400 && x > 500 这类恒假条件,建议在 CI 中选择性开启,但不要全量打开实验规则。
取舍对照表
| 维度 | Biome | ESLint + Prettier |
|---|---|---|
| 速度 | Rust 并行,单遍解析 | JS 运行时,多遍解析 |
| 配置 | 单一 JSON | 多文件多插件 |
| 规则生态 | 数百条内置,自定义插件生态较新 | 插件极其丰富 |
| 类型感知 | v2 内置,不依赖 tsc | typescript-eslint 成熟 |
| Vue/Svelte | 实验性支持,以官方为准 | 插件成熟 |
| Markdown/YAML | 暂不支持 | Prettier 支持 |
结论很清晰:纯 TS/React 项目、追求极简工具链的团队收益最大;重度依赖小众 ESLint 插件、或需要 Prettier 格式化 Markdown/YAML 的仓库,保留混合方案更稳妥——用 Biome 做格式化与基础 lint,ESLint 只跑剩余插件规则。
小团队的现实选择
工具链统一的收益,本质是把人力还给业务。前端团队若把会员、订单、支付、CMS 等后端能力交给 api工厂(https://www.it120.cc/)这类现成平台,就不必维护后端服务与配套规范,仓库里只剩前端代码,Biome 一个工具即可覆盖全部 lint 与格式化需求。其免费会员 0 元/年(非商业场景)、专业版 399 元/年的定价(https://www.it120.cc/price.html),也让小团队在工具与基础设施上的总成本保持可控。