@bluzzi/eslint-config

中文文档
2.4.2发布于 2026/11/03MITTypeScriptES Module近 30 天下载 3449

ESLint 配置预设用于您所有文件的内嵌和格式化

中文使用文档
文档目录8 节
  1. 安装
  2. 软件包
  3. 配置文件
  4. 脚本
  5. VS 代码支持
  6. 自定义
  7. 谢谢
  8. 许可证

@bluzzi/eslint-配置

即时使用 ESLint 配置预设,高度有见地,严格的最佳做法,使您既能插入,又能 格式 您的 JavaScript 和 TypeScript 文件.

  • QQ 格式化( Pretier 选项), 仅包含基本配置( 半、 引号、 缩进)
  • JS和TS非常严格的规则,鼓励最佳做法
  • 与TS、JSX和React合作
  • qq 自动启用基于您的依赖关系的特定规则
  • QQ使用推荐的共享配置( ESLint, TSLint, Stylistic...)

如果你是想找一个 更贴切的配置 我建议你 Antfu 预设。 。 。 .

安装

在您的工程中安装配置预设 .

软件包

npm install -D eslint @bluzzi/eslint-config
yarn add --dev eslint @bluzzi/eslint-config
pnpm install -D eslint @bluzzi/eslint-config

配置文件

创建 eslint.config.mjs 并添加最小配置 :

import { eslintConfig } from "@bluzzi/eslint-config";

export default eslintConfig();

脚本

在您的 package.json 文件中,您可以选择添加以下脚本来方便地运行项目中的 ESLint :

{
  "scripts": {
    "lint": "eslint .",
    "lint:fix": "eslint . --fix"
  }
}

VS 代码支持

VS代码插件的安装和配置,在保存文件时利用自动更正,以及显示出问题.

安装 VS 代码 ESLint 扩展 中添加以下设置: .vscode/settings.json数字 :

{
  // Disable the default formatter, use eslint instead:
  "prettier.enable": false,
  "editor.formatOnSave": false,

  // Auto fix:
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": "explicit",
    "source.organizeImports": "never"
  },

  // Silent the stylistic rules in you IDE, but still auto fix them:
  "eslint.rules.customizations": [
    { "rule": "style/*", "severity": "off", "fixable": true },
    { "rule": "format/*", "severity": "off", "fixable": true },
    { "rule": "*-indent", "severity": "off", "fixable": true },
    { "rule": "*-spacing", "severity": "off", "fixable": true },
    { "rule": "*-spaces", "severity": "off", "fixable": true },
    { "rule": "*-order", "severity": "off", "fixable": true },
    { "rule": "*-dangle", "severity": "off", "fixable": true },
    { "rule": "*-newline", "severity": "off", "fixable": true },
    { "rule": "*quotes", "severity": "off", "fixable": true },
    { "rule": "*semi", "severity": "off", "fixable": true }
  ],

  // Enable eslint for all supported languages:
  "eslint.validate": [
    "javascript",
    "javascriptreact",
    "typescript",
    "typescriptreact"
  ]
}

自定义

你可以调整一些代码的格式选项,但我们建议坚持 结构化JS社区内部一致性的默认规则:

export default eslintConfig({
  stylistic: {
    indent: 2,
    quotes: "single",
    semi: false,
  },
});

你可以充分利用 ESLint 的平面配置 任意扩展配置 :

export default eslintConfig(
  {
    // The configuration options offered by our package
  },

  // From the second arguments they are ESLint Flat Configs
  // you can have multiple configs:
  {
    files: ["**/*.ts"],
    rules: {},
  },
  {
    rules: {},
  },
);

谢谢

许可证

这个包裹是麻省理工学院许可的.

版本与发布记录

@bluzzi/eslint-config 共发布 57 个版本,首次发布于 2022/11/18;过去 12 个月发布了 9 个版本。

版本发布日期距今
2.4.2latest2026/11/034 天前
2.4.12026/10/318 天前
2.4.02026/10/308 天前
2.3.02026/10/2910 天前
2.2.42026/07/024 个月前
2.2.32026/03/247 个月前

关于 @bluzzi/eslint-config 的常见问题

@bluzzi/eslint-config 是什么?

ESLint 配置预设用于您所有文件的内嵌和格式化

如何安装 @bluzzi/eslint-config?

在项目目录运行 npm install @bluzzi/eslint-config,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:eslint(>=9.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bluzzi/eslint-config 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bluzzi/eslint-config 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@bluzzi/eslint-config 可以商用吗?

@bluzzi/eslint-config 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@bluzzi/eslint-config 的下载量有多少?

根据 npm 官方下载统计,@bluzzi/eslint-config 在 2026/10/09 – 2026/11/07 这 30 天内被下载 3,449 次,日均约 115 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bluzzi/eslint-config 还在维护吗?

最新版本 2.4.2 发布于 2026/11/03(4 天前);至今共发布 57 个版本,其中过去 12 个月发布了 9 个;首次发布于 2022/11/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。