Biome

代码规范对 AI 生成的代码格外重要：AI 每次写的风格可能都不一样，格式化工具让它们统一；静态检查能在运行前拦下未使用的变量、错误的 Hook 用法、可访问性问题。

为什么是首选

• 一个工具管两件事。 以前要装 ESLint、Prettier、一堆插件和让它们不打架的配置；Biome 一个依赖、一个 biome.json 就够了。
• 快。 用 Rust 写成，整个项目检查一遍通常不到一秒，AI 每次改动后都跑也不心疼。
• 规则开箱可用。 推荐规则集覆盖常见错误，还有针对 React、Next.js、测试代码的规则域。
• 能自动修。 biome check --write 会修好格式、排好 import，并应用安全的修复。

上手

pnpm add -D -E @biomejs/biome
pnpm exec biome init

再在 package.json 里加两条脚本："lint": "biome check ." 和 "format": "biome check --write ."。

从 ESLint + Prettier 迁移

Biome 提供 biome migrate eslint 和 biome migrate prettier，能把现有配置转换过来。迁移后先跑一遍 biome format，确认格式差异很小，再一次性提交。这个网站就是这样迁移过来的：全仓库只有一处格式差异。

给 AI 的规矩

• 改动后运行 pnpm format，再运行 pnpm lint。
• 不要用忽略注释绕过规则；确实需要豁免时，在注释里写明理由。

{
  "$schema": "https://biomejs.dev/schemas/2.5.15/schema.json",
  "vcs": {
    "enabled": true,
    "clientKind": "git",
    "useIgnoreFile": true
  },
  "formatter": {
    "enabled": true,
    "indentStyle": "space",
    "indentWidth": 2,
    "lineWidth": 100
  },
  "javascript": {
    "formatter": {
      "quoteStyle": "single",
      "trailingCommas": "all"
    }
  },
  "linter": {
    "enabled": true,
    "rules": {
      "preset": "recommended"
    },
    "domains": {
      "react": "recommended",
      "test": "recommended"
    }
  },
  "assist": {
    "actions": {
      "source": {
        "organizeImports": "on"
      }
    }
  }
}