@ariestools/eslint-config-flat

中文文档
10.3.0发布于 2026/11/07LGPL-3.0-onlyTypeScriptES Module近 30 天下载 6225

Aries 工具类型软件包的 ESLint 9/10 平面配置级

中文使用文档
文档目录9 节
  1. 安装
  2. 使用量
  3. 等级
  4. 以习惯规则扩展
  5. 个人配置
  6. 包括什么
  7. 规则所有权
  8. 许可证
  9. 贷项

logo

@ liastools/ slint- config- blat( 平面)

npm license

Aries 工具类型软件包的 ESLint 9/10 平面配置级

安装

需要22号节点. 小时 完全支持; npm / 纱线 / bun 是实验性.

pnpm add -D @ariestools/eslint-config-flat

端点 : eslint ^10.3 和 (单位:千美元) eslint-import-resolver-typescript ^ 4.4.

使用量

import { recommendedConfig } from '@ariestools/eslint-config-flat'

export default [
  ...recommendedConfig({ tier: 3, isTypeChecked: true }),
]

recommendedConfig 接受:

选项默认说明
tier3预设严格级别(0-4)
isTypeCheckedtrue启用类型脚本类型检查规则

何时 isTypeChecked 实值 false,所有要求解析器类型信息的规则都会被禁用,一个安全网门会关闭任何本可继续运行的被打字的预设规则.

等级

每一级是 超级集 上一级.

级别类别说明
0 个正确性类型安全、防虫、进口限制、减值
1个一致性0级+格式化,成员顺序,复杂度限制
2个最佳做法1级+独角兽,导入验证,工作空间规则
3个有意见(违约)第二级+独角兽观点规则和可选规则被推向错误
页:1实验与第三级相同的独角兽断裂;保留给未成年人可能改变的规则

规则等级分配 RULE_CATALOG (从本包出). 命名出口, 如 configTier3OpinionatedTypeChecked 仍可使用,但已贬值。 偏爱 recommendedConfig({ tier: 3, isTypeChecked: true })。 。 。 .

独角兽规则 防止严重性 eslint-plugin-unicorn。明确的 XY 覆盖 RULE_CATALOG 财务报告和审定财务报表 unicornConfig启用 xy lint --strict (或 XY_STRICT=1将警告视为CI中的错误.

以习惯规则扩展

import { recommendedConfig } from '@ariestools/eslint-config-flat'

export default [
  ...recommendedConfig({ tier: 3, isTypeChecked: true }),
  {
    rules: {
      // your overrides
    },
  },
]

个人配置

import {
  importConfig,
  rulesConfig,
  typescriptConfig,
  unicornConfig,
} from '@ariestools/eslint-config-flat'

JSON/标记下帮助: jsonConfig, (中文(简体) ), docsConfig。此软件包中没有 SonarJS 配置(xy sonar 是单独隔离的CLI命令).

包括什么

  • TypeScript 严格通过内嵌 @typescript-eslint
  • 通过 eslint-plugin-import-x
  • 最佳做法 eslint-plugin-unicorn
  • Monorepo 工作空间规则通过 eslint-plugin-workspaces
  • 标记倒挂通过 @eslint/markdown
  • 结构化格式化(无分号,单引号,后缀逗号,2-空格缩进)

对于反应项目, 使用 @ariestools/eslint-config-react-flat 换句话说.

规则所有权

一些插件覆盖了类似的域. 此配置为每个顾虑指定了单一的犬类所有者并禁用相重叠的规则. 见 RULE_OWNERSHIP_GROUPS 财务报告和审定财务报表 assertNoRuleOwnershipConflicts。 。 。 .

升级 ESLint 插件时, 在此套件中运行测试 - spec/plugin-rules.spec.ts 抓取每个插件的规则列表, 当新规则出现时失败 .

许可证

LGPL -3.0 -仅限. 见 自由主义 (LGPLv3)和 乘车 (GPLv3,由LGPL-3)合并而成.

贷项

由 Aries 工具制作

版本与发布记录

@ariestools/eslint-config-flat 共发布 62 个版本,首次发布于 2026/07/08;过去 12 个月发布了 62 个版本。

版本发布日期距今
10.3.0latest2026/11/07今天
10.2.22026/10/317 天前
10.2.12026/10/2612 天前
10.2.02026/10/1226 天前
10.1.52026/10/1028 天前
10.1.42026/10/1029 天前

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

@ariestools/eslint-config-flat 是什么?

Aries 工具类型软件包的 ESLint 9/10 平面配置级

如何安装 @ariestools/eslint-config-flat?

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

@ariestools/eslint-config-flat 支持 TypeScript 吗?

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

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

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

@ariestools/eslint-config-flat 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@ariestools/eslint-config-flat 可以商用吗?

@ariestools/eslint-config-flat 使用 LGPL-3.0-only 许可。弱 Copyleft:作为库被调用时通常不要求开源你自己的代码,但修改库本身需以 LGPL 开源;前端打包合并后的适用边界存在不同理解。以上为概括,不构成法律意见,请以许可原文为准。

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

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

@ariestools/eslint-config-flat 还在维护吗?

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