SuperAPI AI 工具集

no-explicit-any

编程与开发

查看项目

更新于 10-16 06:15

技能介绍

用途:审查 TypeScript 文件中的类型安全回归,尤其适用于处理外部数据的函数代码评审,或代码库中已配置 ESLint 的场景。核心目标是避免 any 类型,改用 unknown、泛型或类型守卫。

主要能力:

  • 扫描 TypeScript 文件中的 any 用法,包括显式注解、缺少类型导致的隐式 any,以及断言为 any 的类型断言,并报告位置与更安全的替代方案。
  • 修复:将 any 替换为 unknown(未知形状的值)、合适的泛型(类型一致的操作)或 Zod 校验(外部数据),并说明每个使用点所需的类型收窄或泛型约束。
  • 解释:说明 any 为何削弱 TypeScript 的保证、unknown 与 any 的区别,以及 as Type 断言何时可接受、何时危险。
  • 代码评审:审查类型注解、函数签名与外部数据处理,标记显式或隐式的 any、缺少前置类型守卫的 any 断言,以及由无类型依赖推断为 any 的返回类型。

要点:any 会关闭某个值的全部类型检查并级联到调用方;unknown 是安全替代,使用前必须做类型检查;泛型用于表达“接受任意类型但保持一致”;API 边界处应使用 Zod 校验,而不是用 as Type 断言。

限制:官方资料未提供具体安装命令、平台支持、价格与性能数据;完整实现细节、代码示例和框架相关指导见 references/rule.md。规则页面:https://frontendchecklist.io/rules/javascript/no-explicit-any