@fido.id/eslint-config-fido

中文文档
2.2.2发布于 2025/09/15MITCommonJS近 30 天下载 5820

Fido.id 共享 ESLint 配置,旨在改进反应应用程序的代码质量

中文使用文档
文档目录9 节
  1. 目录
  2. 安装
  3. 使用量
  4. 导出配置
  5. 实例:eslint.config.js
  6. CLI 使用量
  7. 自定义 pretier
  8. 自定义规则
  9. 哲学

埃斯林特- 配置- fido

用于 Typescript & React 项目的共享ESLint配置.

目录

安装

yarn add --dev @fido.id/eslint-config-fido

您还需要安装 eslint 财务报告和审定财务报表 prettier数字 :

yarn add --dev eslint prettier

使用量

导出配置

此套件会导出两个主要配置 :

  • 建议:所有TypeScript项目的基本规则(没有React/JSX特定规则).
  • 反应: 以附加规则来扩展基础配置 React/JSX 项目.

实例:eslint.config.js

const fido = require("@fido.id/eslint-config-fido");
module.exports = [
  // For TypeScript projects:
  ...fido.configs.recommended,
  // For React/JSX projects, use:
  // ...fido.configs.react,
  {
    rules: {
      // your custom rules here
    },
  },
];

CLI 使用量

这个软件包为运行测试、内嵌和安装依赖性提供了CLI:

  • ./cli start 在多克容器内安装所有项目依赖性.
  • ./cli tests 进行所有测试.
  • ./cli tests --fix ——运行起伏并自动解决问题.

说明: CLI要求多克安装和运行在您的系统中.

自定义 pretier

如果您想要自定义 Pretier 设置, 请创建一个名为 .prettierrc 在您的工程目录中。 此文件必须像这样声明 Pretier 配置 :

{
  "printWidth": 100,
  "tabWidth": 2,
  "singleQuote": true,
  "jsxBracketSameLine": true,
  "trailingComma": "es5"
}

自定义规则

此套件提供以下自定义的ESLint规则:

规则名称说明有效示例无效的示例解释
no-nested-ternary-operators损坏嵌入式三角操作器,以提高可读性.const x = a ? b : c;const x = a ? (b ? 1 : 2) : 3;巢穴取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取来. 有取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取.
prefer-early-returns更喜欢提前返回(保护条款),而不是只包含一个如果的区块.function f(a){ if (!a) return; doWork(a); }function f(a,b){ if (a > 0) { doA(); } else if (b > 0) { doB(); } else { doC(); } }避免了深筑巢,并通过使用护卫条款而不是其他/else-if来提高代码清晰度.
prefer-object-parameters为具有许多参数的函数偏好一个单一对象参数,以提高可读性和可扩展性.function foo({a, b, c, d, e}) {}function foo(a, b, c, d, e) {}当一个函数需要超过一组参数(默认:4)时,使用单个对象参数而不是多个位置参数.
mui-prefer-components在JSX中存在等同物时,优于原生HTML元素的材料UI组件.<Box><Typography>Text</Typography></Box><div><p>Text</p></div>强制使用MUI组件(如Box,Typography,Button)来代替JSX中的原生HTML标记来与设计系统保持一致.

哲学

这个配置旨在将严重的问题(例如:语法错误)标记为错误,而语法问题则标记为警告. 这让你的团队应用诸如"确保承诺没有出错,但如果承诺没有引入警告,则忽略警告"的政策

版本与发布记录

@fido.id/eslint-config-fido 共发布 11 个版本,首次发布于 2022/09/23;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.2.2latest2025/09/151.2 年前
2.2.12025/09/051.2 年前
2.2.02025/09/051.2 年前
2.1.02025/08/291.2 年前
2.0.02025/08/081.3 年前
1.3.02024/05/102 年前

关于 @fido.id/eslint-config-fido 的常见问题

@fido.id/eslint-config-fido 是什么?

Fido.id 共享 ESLint 配置,旨在改进反应应用程序的代码质量

如何安装 @fido.id/eslint-config-fido?

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

@fido.id/eslint-config-fido 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/fido.id__eslint-config-fido 是否存在。

@fido.id/eslint-config-fido 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

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

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

@fido.id/eslint-config-fido 可以商用吗?

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

@fido.id/eslint-config-fido 的下载量有多少?

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

@fido.id/eslint-config-fido 还在维护吗?

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