用途:Biome 2.x 是面向 JavaScript、TypeScript、JSX 和 JSON 的一体化代码质量工具链,用 Rust 编写,用于替代 ESLint 与 Prettier,完成 lint 与格式化。
主要能力:支持 lint、格式化、导入排序;提供推荐规则集,并可按 a11y、complexity、correctness、performance、security、style、suspicious 等类别配置规则;支持按文件覆盖规则;支持从 ESLint/Prettier 迁移。
安装与初始化:pnpm add -D @biomejs/biome;pnpm biome init;随后配置 biome.json,安装 VS Code 扩展 biomejs.biome,并添加 npm 脚本。
常用命令:pnpm biome check .(检查);pnpm biome check --write .(自动修复);pnpm biome lint --write .;pnpm biome format --write .;pnpm biome rage(诊断配置);pnpm biome explain src/App.tsx;pnpm biome migrate eslint --write;pnpm biome migrate prettier --write。
配置:biome.json 可设置 organizeImports、linter、formatter(indentStyle、indentWidth、lineWidth)、javascript.formatter(quoteStyle、semicolons、trailingCommas、arrowParentheses)以及 files.ignore。可用 overrides 为 tests、scripts 等目录设置不同规则。
集成:VS Code 中设置默认格式化器为 biomejs.biome、开启保存时格式化与保存时代码操作,并关闭 ESLint/Prettier。Git 钩子可用 lint-staged + Husky 或 Lefthook 在提交前运行 biome check --write。CI 中可在 GitHub Actions 安装依赖后运行 pnpm biome check . 与 pnpm typecheck。
忽略代码:可用 // biome-ignore lint/... 或 // biome-ignore format: 注释,但整目录忽略建议使用 biome.json 的 files.ignore。
限制与注意:资料未提供性能基准、价格或平台支持范围;建议使用 biome check 而非分别运行 lint 与 format,避免在同一项目混用 ESLint 与 Biome,迁移前应充分测试,并将 biome.json 提交到版本控制。