Biome
Biome 中文站,译自官方文档 v2.5.13

一条命令,跑完格式化与 Lint

Rust 编写的 Web 工具链:与 Prettier 兼容度 97%,收录 545 条 Lint 规则,不装 Node.js 也能运行。

.ts.tsx.js.css.json.md共享基座一个解析器、具体语法树(CST)、全保真源文本、并行与缓存格式化97% 兼容 PrettierLint545 条规则Assist10 项辅助操作风格统一带修复建议的诊断导入已排序$ biome check --write ./src

三条通道,同一个解析器

过去这些能力分散在不同工具里,各自解析、各自报错。Biome 把它们合到一套基座上,配置、输出与缓存行为因此保持一致。

  • 格式化

    对 JavaScript、TypeScript、JSX、JSON、CSS、GraphQL、HTML、Markdown 输出一致风格,默认与 Prettier 高度兼容。

    biome format --write
    看格式化文档
  • Lint

    收录来自 ESLint、typescript-eslint 与其他来源的规则,诊断信息带上下文,并区分安全修复与不安全修复。

    biome lint --write
    看 Linter 文档
  • Assist 辅助操作

    整理导入、排序对象键与属性、给联合类型与枚举成员排序,这一类操作始终提供可用的代码修复。

    biome check --write
    看 Assist 文档

装上就跑,输出看得懂

三步进入项目:安装并锁定版本、生成配置、跑检查。下面是 Biome 2.5.13 对一个含问题文件执行 biome check 的真实输出。

  1. 安装npm install --save-dev --save-exact @biomejs/biome
  2. 初始化npx @biomejs/biome init
  3. 检查并修复npx @biomejs/biome check --write ./src
$ npx @biomejs/biome check ./src
src\app.ts:1:1 assist/source/organizeImports  FIXABLE  ━━━━━━━━━
  × Sort these imports.

  > 1 │ import { z } from "zod";
      │ ^^^^^^^^^^^^^^^^^^^^^^^^
  > 2 │ import express from "express";
      │ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  i Safe fix: Organize imports and exports (Biome)
  … diff 正文省略

src\app.ts:8:12 lint/suspicious/noDoubleEquals  FIXABLE  ━━━━
  × Using == may be unsafe if you are relying on type coercion.

     7 │   var port = opts.port
   > 8 │   if (port == 3000) {
       │            ^^
  … diff 正文省略

src\app.ts format  ━━━━━━━━━━━━━━
  × Formatter would have printed the following content:

Checked 1 file in 10ms. No fixes applied.
Found 3 errors.

同一个文件,一条命令同时给出格式问题、Lint 问题与安全修复建议。


97%与 Prettier 的格式化兼容度兼容度来源
545条 Lint 规则,来自 ESLint 等生态规则来源对照
10项 Assist 辅助操作(整理导入、排序键等)看 Assist
2.5.13本站正文对应的 Biome 版本上游发布页

在你现在的编辑器里工作

Biome 从设计之初就面向编辑器:写代码时即时格式化并指出不规范之处,通过 Language Server 协议与编辑器通信。

CI 里用 biome ci

biome check 行为一致,但为 CI 环境优化,不做写入。

name: CI
on: [push]
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: biomejs/setup-biome@v2
        with:
          version: 2.5.13
      - run: biome ci .

我们告诉你的不只是哪里错了,还包括错在哪一行、为什么、以及怎么修。

译自 Biome 官方对诊断信息的设计说明
Prettierbiome format
ESLint 的格式化类规则biome format
ESLint 与 typescript-eslint 的多数规则biome lint
eslint-plugin-import 的排序能力biome assist
husky + lint-staged 的手写脚本biome ci 与 Git Hooks 配方
看迁移步骤