Biome 中文站,译自官方文档
v2.5.13一条命令,跑完格式化与 Lint
Rust 编写的 Web 工具链:与 Prettier 兼容度 97%,收录 545 条 Lint 规则,不装 Node.js 也能运行。
三条通道,同一个解析器
过去这些能力分散在不同工具里,各自解析、各自报错。Biome 把它们合到一套基座上,配置、输出与缓存行为因此保持一致。
格式化
对 JavaScript、TypeScript、JSX、JSON、CSS、GraphQL、HTML、Markdown 输出一致风格,默认与 Prettier 高度兼容。
biome format --write看格式化文档
装上就跑,输出看得懂
三步进入项目:安装并锁定版本、生成配置、跑检查。下面是 Biome 2.5.13 对一个含问题文件执行 biome check 的真实输出。
- 安装
npm install --save-dev --save-exact @biomejs/biome - 初始化
npx @biomejs/biome init - 检查并修复
npx @biomejs/biome check --write ./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 问题与安全修复建议。
在你现在的编辑器里工作
Biome 从设计之初就面向编辑器:写代码时即时格式化并指出不规范之处,通过 Language Server 协议与编辑器通信。
- VS Code第一方扩展,保存即格式化与修复
biomejs.biome - IntelliJ 系列第一方插件,走 Language Server 协议
JetBrains Marketplace - Zed第一方扩展,格式化与代码操作
zed: extensions - Vim、Neovim、Sublime Text 等社区扩展与通用 LSP 客户端
第三方扩展
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 官方对诊断信息的设计说明
Prettier→
biome formatESLint 的格式化类规则→
biome formatESLint 与 typescript-eslint 的多数规则→
biome linteslint-plugin-import 的排序能力→
biome assisthusky + lint-staged 的手写脚本→
看迁移步骤biome ci 与 Git Hooks 配方45 篇中文文档
覆盖入门、核心能力、编辑器、参考、配方与项目内部机制。逐条规则的详情页仍以上游英文站为准,站内提供规则来源对照表。