SuperAPI AI 工具集

type-only-imports

编程与开发

查看项目

更新于 10-16 06:56

技能介绍

用途

该技能用于处理 TypeScript 中的类型导入问题。当需要审计 TypeScript 文件中的 import 语句、搭建新的 TypeScript 项目,或排查因类型导入导致的非预期打包内容时,可使用该技能。

主要能力

  • 审查 TypeScript 文件中的 import 语句,识别出仅使用类型或接口的导入。
  • 将仅用作 TypeScript 类型注解、而非运行时值的常规 import 转换为 import type。
  • 解释 TypeScript 中 import 与 import type 的区别,说明为何应显式声明类型导入,以及 verbatimModuleSyntax 如何在编译器层面强制这一点。
  • 在代码审查中检查每个导入名称是仅出现在类型位置(注解、泛型、implements 子句),还是出现在运行时位置(函数调用、new、typeof),并标记仅用作类型的常规 import。

使用方式

技能提供检查、修复、解释和代码审查四类操作:

  • 检查:审查当前 TypeScript 文件中的 import 语句,找出仅使用类型或接口的导入。
  • 修复:将识别出的常规 import 转换为 import type,条件是导入的绑定仅用作 TypeScript 类型注解而非运行时值。
  • 解释:说明 import 与 import type 的差异、显式声明类型导入的原因,以及 verbatimModuleSyntax 的编译器级强制机制。
  • 代码审查:逐一检查文件中的所有 import 语句,判断导入名称出现在类型位置还是运行时位置,标记仅用作类型的常规 import。

适用场景

  • 审计 TypeScript 文件中的 import 语句。
  • 搭建新的 TypeScript 项目。
  • 排查因类型导入导致的非预期打包内容。
  • 代码审查中检查导入语句的类型使用情况。

限制

资料未提供该技能的具体实现细节、代码示例和框架相关指导,仅说明可参见 references/rule.md。规则页面为 https://frontendchecklist.io/rules/javascript/type-only-imports。