typescript-eslint 是什么

typescript-eslint 是让类型检查器与 ESLint 协作的插件体系：一部分规则只做语法分析，另一部分需要读取类型信息，因此能发现「忘记等待 Promise」「把 any 一路传下去」这类纯语法规则看不到的问题。代价是需要构建类型信息，首次运行与大型仓库的开销明显更高。

基本信息

规则配置示例

rules: {
  "@typescript-eslint/no-floating-promises": "error",   // 未处理的 Promise
  "@typescript-eslint/no-misused-promises": "error",    // Promise 用在同步位置
  "@typescript-eslint/no-explicit-any": "warn",         // 显式 any
  "@typescript-eslint/await-thenable": "error"          // 对非 Promise 使用 await
}

落地策略

• 源码目录开启类型感知规则，生成代码与测试目录使用轻量配置。
• 从 recommended 起步，再逐类提升到严格预设，避免一次全开。
• 确认类型配置指向正确：指向不完整时类型规则可能不报错也不生效。
• 把检查接入 CI，并为大型仓库预留构建时间。
• 用错误码或规则名做局部豁免，并写明原因。
• 为类型感知规则单独跑一条流水线：失败时能直接看出是类型问题而不是运行问题。
• 报错时优先修类型本身：用类型断言绕过检查，等于把问题推迟到运行时。

类型感知的收益