跳过主要内容
文档目录

代码检查

在 MinuteShip 中使用 Biome 进行代码质量管理

MinuteShip 使用 Biome 进行代码格式化和代码检查，以确保项目保持一致的代码质量。

Biome 在项目根目录中通过 biome.json 进行配置，此配置强制执行一致的代码风格并捕获常见错误。

运行代码检查和格式化

检查代码质量

要检查您的代码而不进行更改：

pnpm run lint

此命令只执行 Biome 检查。需要自动修复时执行 pnpm fix；只格式化时执行 pnpm format。

pnpm check 依次执行 lint、test、build、typecheck 和本地 e2e，任一步失败即停止。检查不自动修复源文件，但会生成语言、路由与构建产物，并初始化隔离的 E2E 本地数据。详见自动化测试。

格式化代码

要自动格式化您的代码：

pnpm run format

此命令将根据项目的代码格式规则格式化所有支持的文件。

自定义规则

项目的 Biome 配置在 biome.json 中定义。以下是我们配置的简化视图：

biome.json

{
  "$schema": "https://biomejs.dev/schemas/2.3.12/schema.json",
  "formatter": {
    "enabled": true,
    "indentStyle": "space",
    "indentWidth": 2,
    "lineWidth": 80
  },
  "assist": { "actions": { "source": { "organizeImports": "off" } } },
  "linter": {
    "enabled": true,
    "rules": {
      "recommended": true,
      // 各种规则自定义...
    }
  },
  "javascript": {
    "formatter": {
      "quoteStyle": "single",
      "trailingCommas": "es5",
      "semicolons": "always"
    }
  }
}

有关如何自定义规则配置的更多信息，请参考 Biome 代码检查规则文档。

编辑器集成

Biome 与您的编辑器集成时效果最佳：

  • VSCode/Cursor：安装 Biome 扩展 以获得实时代码检查和格式化
  • 其他编辑器：查看 Biome 文档 了解集成选项

MinuteShip 为 Biome 提供了预配置的 VSCode/Cursor 设置，这些设置确保：

  • Biome 用作 JavaScript 和 TypeScript 文件的默认格式化器
  • 保存时自动格式化文件
  • 当前 biome.json 关闭导入排序，编辑器中配置的动作不会自动启用它

.vscode/settings.json

{
  "editor.defaultFormatter": "biomejs.biome",
  "[javascript]": {
    "editor.defaultFormatter": "biomejs.biome"
  },
  "[typescript]": {
    "editor.defaultFormatter": "biomejs.biome"
  },
  "[typescriptreact]": {
    "editor.defaultFormatter": "biomejs.biome"
  },
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "quickfix.biome": "explicit",
    "source.organizeImports.biome": "explicit"
  }
}

下一步

现在您了解了如何在 MinuteShip 中维护代码质量，探索这些相关主题：