跳到主要内容
api工厂
工程化

Biome 一体化工具链:lint+format 替代 ESLint+Prettier 的取舍

api工厂资讯栏目 约 5 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。
内容摘要Biome 以单遍解析统一 lint 与格式化,官方宣称约 97% Prettier 兼容。本文覆盖配置、migrate 迁移、biome ci 与钩子接入及取舍对照。

结论先行: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),因为格式化结果可能随版本变化:

bash
npm install --save-dev --save-exact @biomejs/biome
npx biome init

biome.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 中选择性开启,但不要全量打开实验规则。

取舍对照表

维度BiomeESLint + Prettier
速度Rust 并行,单遍解析JS 运行时,多遍解析
配置单一 JSON多文件多插件
规则生态数百条内置,自定义插件生态较新插件极其丰富
类型感知v2 内置,不依赖 tsctypescript-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),也让小团队在工具与基础设施上的总成本保持可控。

文章标签

BiomeESLintPrettier工具链

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。

前端测试VitestPlaywright

前端测试金字塔:Vitest 单元测试 + Playwright E2E 落地

按测试金字塔划分单测、组件测试与 E2E 职责,给出 Vitest 与 Playwright 配置示例、真实商城链路用例、CI 分段策略与闪断治理方法。

工程化约 6 分钟阅读