🌿
Biome · Rust 工具链

Biome 完全指南

一个 Rust 二进制取代 ESLint + Prettier——格式化与 lint 快 35 倍,零配置开箱即用,JS/TS/JSX/JSON 全覆盖

单一二进制
35× Prettier 速度
零依赖
Prettier 97% 兼容
内置 LSP
35× 比 Prettier 快
10 核心章节
280+ 内置规则

Biome 为什么值得学?

前端工程一直被一个问题困扰:ESLint 管 lint、Prettier 管格式化、tsc 管类型——三个工具、三套配置、三份插件生态,任何一个改版都可能让 CI 卡半天。更糟的是,它们都是 JavaScript 写的,项目稍大就能让 lint + format 跑 20 秒以上。

Biome(前身 Rome,2023 年 fork 后独立演进)用 Rust 重写了整个工具链:一个二进制、一个 biome.json 配置、同时做格式化与 lint;对于万行级前端项目,Biome 通常能在 200ms 内完成全部检查——这让 lint-staged、pre-commit、保存时格式化彻底没有延迟。2024 年 Biome 1.x 稳定,2025 年 v2 带来 TS 类型推断规则、CSS/GraphQL 支持、Domain 规则组——成为 Next.js、Turborepo、Astro、Bun 官方模板的默认 lint/format 工具。

本教程 10 章从零讲到精通:安装、biome.json 配置、format 用法、lint 规则、check 组合命令、migrate 从 ESLint/Prettier 迁移、CI 集成、VSCode 插件、monorepo 配置、自定义规则与 GritQL。

核心能力

六大特性让 Biome 成为 2026 年默认的前端工具链

Rust 级性能

单机 35× Prettier、15× ESLint——万行项目 200ms 完成,保存时无感。

📦

一个二进制搞定

format + lint + import 整理一体化,不用再装 20 个 eslint-plugin-*。

🎯

Prettier 97% 兼容

风格与 Prettier 一致,迁移基本零成本;差异有明确 diff 文档。

🔍

280+ 内置规则

覆盖 ESLint core、TypeScript、React、a11y、Next.js、import 排序。

🛠

内置迁移工具

biome migrate eslint / prettier 一键读取旧配置转 biome.json。

🌐

LSP 原生支持

VSCode、Zed、JetBrains 插件直连,IDE 提示与 CLI 完全一致。

课程目录

10 章从安装到 CI/monorepo,覆盖日常全部场景

Chapter 01

认识 Biome 与安装

Biome 的定位、与 ESLint/Prettier/dprint 对比、npm/bunx 安装、init 第一次配置。

入门 对比
Chapter 02

biome.json 配置全解

formatter/linter/organizeImports 三大模块、files.include/ignore、$schema、extends 继承。

配置 schema
Chapter 03

format 命令实战

formatter 启用、indent/lineWidth/quoteStyle/trailingCommas、与 Prettier 行为差异、stdin 模式。

format prettier
Chapter 04

lint 规则与严重级别

rules 开启/关闭/warn/error、recommended 预设、suspicious/style/correctness 分组、noOneOff。

lint rules
Chapter 05

check 与自动修复

check 组合命令、--write、--unsafe、安全修复 vs 不安全修复、lint-staged 集成。

check autofix
Chapter 06

从 ESLint / Prettier 迁移

biome migrate eslint/prettier、规则对照表、.eslintrc → biome.json、保留哪些 ESLint、CI 并存。

迁移 eslint
Chapter 07

VSCode / Zed / JetBrains 插件

biomejs.biome 插件、defaultFormatter、保存时自动 format、LSP 配置、组织导入。

IDE LSP
Chapter 08

CI/CD 集成

GitHub Actions、biome ci 命令、reporter=github、--changed、PR diff 注释、pre-commit hook。

CI github-actions
Chapter 09

Monorepo 与共享配置

Turborepo/pnpm 下的 biome 配置、root extends、每包 overrides、共享 biome-config 包。

monorepo turborepo
Chapter 10

Domain 规则与 GritQL 进阶

Biome v2 domain(next/react/solid)、GritQL 模式匹配、自定义规则、CSS/GraphQL 支持、未来路线。

进阶 GritQL