用途
该技能用于处理 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。