# @ariestools/eslint-config-flat 中文文档

规范地址：https://npmcn.com/package/%40ariestools/eslint-config-flat/

版本：10\.3\.0
npm 元数据更新时间：2026-11-06T23:04:03.198Z
中文译文更新时间：2026-11-06T19:04:31.791Z
软件包许可：LGPL-3\.0-only

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ariestools/eslint-config-flat
原文对照：https://npmcn.com/package/%40ariestools/eslint-config-flat/?lang=original
项目主页：https://github.com/ariestools/toolchain
源码仓库：https://github.com/ariestools/toolchain

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：371 kB，100 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：10 个
- peer 依赖：eslint ^10\.3，eslint-import-resolver-typescript ^4\.4
- 首次发布：2026-07-08T00:19:51.655Z
- 最新版本发布：2026-11-06T23:04:03.000Z
- 近 30 天下载量：6225（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：62（近 12 个月 62 个）

## 中文简介

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

## 安装

```sh
npm install @ariestools/eslint-config-flat
```

也可以使用：`pnpm add @ariestools/eslint-config-flat`、`yarn add @ariestools/eslint-config-flat`、`bun add @ariestools/eslint-config-flat`

## README

[![logo](https://cdn.xy.company/img/brand/XYPersistentCompany_Logo_Icon_Colored.svg)](https://ariestools.ai/)

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

[![npm](https://img.shields.io/npm/v/@ariestools/eslint-config-flat.svg)](https://www.npmjs.com/package/@ariestools/eslint-config-flat) [![license](https://img.shields.io/npm/l/@ariestools/eslint-config-flat.svg)](https://github.com/ariestools/toolchain/blob/main/LICENSE)

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

## 安装

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

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

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

## 使用量

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

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

`recommendedConfig` 接受:

| 选项 | 默认 | 说明 |
| --- | --- | --- |
| `tier` | `3` | 预设严格级别(0-4) |
| `isTypeChecked` | `true` | 启用类型脚本类型检查规则 |

何时 `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中的错误.

### 以习惯规则扩展

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

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

### 个人配置

```ts
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`](https://www.npmjs.com/package/@ariestools/eslint-config-react-flat) 换句话说.

## 规则所有权

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

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

## 许可证

LGPL -3.0 -仅限. 见 [自由主义](https://npmcn.com/package/%40ariestools/eslint-config-flat/LICENSE) (LGPLv3)和 [乘车](https://npmcn.com/package/%40ariestools/eslint-config-flat/COPYING) (GPLv3,由LGPL-3)合并而成.

## 贷项

[由 Aries 工具制作](https://ariestools.ai/)

## 常见问题

### @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 和提交记录判断。