当 ESLint 中已显式将 @typescript-eslint/no-misused-promises 或 @typescript-eslint/no-floating-promises 设为 “off” 却仍报错时，极可能因规则在 overrides 块中被重复启用——需在对应 overrides 内部而非根 rules 中关闭它们。
当 eslint 中已显式将 `@typescript-eslint/no-misused-promises` 或 `@typescript-eslint/no-floating-promises` 设为 `”off”` 却仍报错时，极可能因规则在 `overrides` 块中被重复启用——需在对应 `overrides` 内部而非根 `rules` 中关闭它们。
ESLint 的配置合并机制遵循层级覆盖优先级：overrides 中的 rules 会完全覆盖根级 rules 设置，且 extends（如 @typescript-eslint/recommended-type-checked）所启用的规则默认仅作用于其匹配的文件范围内（例如 **/*.ts）。这意味着：即使你在根 rules 中设 “@typescript-eslint/no-floating-promises”: “off”，只要某个 overrides 块匹配了 .ts 文件并继承了启用该规则的共享配置（如 @typescript-eslint/recommended-type-checked），该规则就会在该作用域内重新生效——而你的根级关闭指令对此无效。
✅ 正确做法是：定位到启用 TypeScript 规则的 overrides 块，并在其内部 rules 中显式关闭目标规则。典型结构如下：
// .eslintrc.js module.exports = { root: true, parser: '@typescript-eslint/parser', plugins: ['@typescript-eslint'], // ⚠️ 根 rules 不影响 overrides 内启用的规则 rules: { // 此处设置对 .ts 文件无效（除非无匹配 overrides） }, overrides: [ { files: ['**/*.ts', '**/*.tsx'], extends: ['@typescript-eslint/recommended-type-checked'], // ← 此处启用了 no-floating-promises 等 rules: { // ✅ 必须在此处关闭，才能覆盖 extends 引入的默认行为 '@typescript-eslint/no-floating-promises': 'off', '@typescript-eslint/no-misused-promises': 'off', // 其他需定制的 TS 规则也放这里 }, }, { files: ['**/*.js'], extends: ['eslint:recommended'], } ], };? 快速诊断建议：
- 检查 overrides 数组长度及每个项的 files/excludedFiles 匹配逻辑；
- 运行 npx eslint –print-config path/to/file.ts 查看该文件最终解析出的完整规则集（含来源路径），确认 no-floating-promises 是否来自 overrides[0].extends；
- 若使用多层配置（如项目根目录 + packages/*/ 下的配置），注意 root: true 位置及配置继承链。
? 额外提示：
- 避免在根 rules 和 overrides.rules 中对同一规则做不同设置，易引发混淆；
- 使用 “off”（字符串）或 0（数字）均可，但推荐统一用字符串以提升可读性；
- 清理缓存（npx eslint –cache –cache-location .eslintcache –cache-strategy content）仅解决文件内容变更未触发重检问题，无法绕过配置逻辑错误。
遵循上述结构化覆盖原则，即可精准控制 TypeScript 特定规则在对应文件类型中的启用状态，彻底解决“规则看似关闭却仍在报错”的典型配置陷阱。