ultracite

超钙石

Ultracite 是基于 Biome 构建的现代 TypeScript 应用程序的强大 linting 配置。它非常固执和严格，强制执行最大程度的类型安全和代码质量。 Ultracite 设置完成后，它会在保存时自动检查、修复和格式化您的代码。

安装

运行以下命令来安装 Ultracite：

pnpm add -D --save-exact ultracite @biomejs/biome

如果您正在运行 VS Code，请确保安装了以下扩展：

code --install-extension biomejs.biome
code --install-extension bradlc.vscode-tailwindcss

设置

创建包含以下内容的biome.json ：

{ "extends" : [ " ultracite " ] }

Ultracite 设计为与 VS Code 一起使用。创建一个包含以下内容的.vscode/settings.json文件，以在保存时启用完整格式化和修复：

{
  "typescript.tsdk" : " node_modules/typescript/lib " ,
  "editor.defaultFormatter" : " biomejs.biome " ,
  "editor.formatOnSave" : true ,
  "editor.formatOnPaste" : true ,
  "emmet.showExpandedAbbreviation" : " never " ,
  "editor.codeActionsOnSave" : {
    "quickfix.biome" : " explicit " ,
    "source.organizeImports.biome" : " explicit "
  },
  "[typescript]" : {
    "editor.defaultFormatter" : " biomejs.biome "
  },
  "[json]" : {
    "editor.defaultFormatter" : " biomejs.biome "
  },
  "[javascript]" : {
    "editor.defaultFormatter" : " biomejs.biome "
  },
  "[jsonc]" : {
    "editor.defaultFormatter" : " biomejs.biome "
  },
  "[typescriptreact]" : {
    "editor.defaultFormatter" : " biomejs.biome "
  }
}

最后，确保您的tsconfig.json （如果存在）包含新的 ESLint 配置并且启用strictNullChecks 。

{
  "compilerOptions" : {
    "strictNullChecks" : true
  }
}

用法

Ultracite 将在保存时自动检查、修复和格式化您的代码。如果您想手动运行 Ultracite，可以使用以下命令来执行此操作：

npx ultracite

配置

虽然 Ultracite 被设计为零配置，但您可以在biome.json文件中修改您想要的任何内容。例如，要启用noAutofocus规则，您可以执行以下操作：

{
  "extends" : [ " ultracite " ],
  "linter" : {
    "rules" : {
      "a11y" : {
        "noAutofocus" : " off "
      }
    }
  }
}

您还可以通过在行末尾添加注释来禁用每行规则：

 // biome-ignore lint/security/noDangerouslySetInnerHtml: I do what I want mate.
< div dangerouslySetInnerHTML = { { ... } } / > 

笔记

Ultracite 之前是基于 ESLint、Prettier 和 Stylelint 构建的。如果您想使用该堆栈，可以使用以下命令安装兼容版本的 Ultracite：

pnpm add -D ultracite@3 eslint@8 prettier stylelint typescript jest