如何通过TypeScript Compiler API获取导入名称的声明类型？

遇到这种情况很正常——直接操作ImportSpecifier节点本身确实拿不到原始声明的信息，得换个思路：先定位到导入的本地标识符，再通过TypeChecker追踪它对应的原始符号，最后从符号的声明节点里提取类型和名称。

具体操作步骤： #

• 首先，从你的ImportSpecifier节点中取出本地标识符，也就是代码里的a，对应节点的localName属性（这是一个Identifier类型的节点）。
• 接着用typeChecker.getSymbolAtLocation(localName)获取这个标识符关联的Symbol对象——这个符号就是模块里导出的原始符号的引用。
• 然后访问symbol.declarations数组，这里面存储了该符号的所有原始声明节点（通常模块导出的符号只有一个主声明，取第一个就行）。
• 最后根据原始节点的kind判断它的类型，再提取名称。

示例代码片段： #

import * as ts from "typescript";

// 假设你已经获取到了program、typeChecker，以及目标ImportSpecifier节点
const localIdentifier = importSpecifier.localName;
const symbol = typeChecker.getSymbolAtLocation(localIdentifier);

if (symbol && symbol.declarations.length > 0) {
  const originalDecl = symbol.declarations[0];
  
  switch (originalDecl.kind) {
    case ts.SyntaxKind.ClassDeclaration:
      const classNode = originalDecl as ts.ClassDeclaration;
      console.log(`类型：ClassDeclaration，名称：${classNode.name?.text || '匿名类'}`);
      break;
    case ts.SyntaxKind.FunctionDeclaration:
      const funcNode = originalDecl as ts.FunctionDeclaration;
      console.log(`类型：FunctionDeclaration，名称：${funcNode.name?.text || '匿名函数'}`);
      break;
    case ts.SyntaxKind.NamespaceDeclaration:
      const namespaceNode = originalDecl as ts.NamespaceDeclaration;
      console.log(`类型：NamespaceDeclaration，名称：${namespaceNode.name.text}`);
      break;
    // 还可以扩展处理其他类型，比如InterfaceDeclaration、VariableDeclaration等
    default:
      console.log(`未处理的声明类型：${ts.SyntaxKind[originalDecl.kind]}`);
  }
} else {
  console.log("无法找到该符号的原始声明，可能模块未被正确解析");
}

几个关键注意事项： #

• 之前得到any类型的原因：如果目标模块不在你的编译范围内（比如没有包含源码或类型定义文件），TypeChecker无法解析到原始声明，就会返回any类型的标识符。确保你的Program实例包含了目标模块的相关文件。
• 针对重导出、默认导出的情况：逻辑类似，但需要对应处理ImportDefaultSpecifier或其他导入节点类型。
• 类型文件（.d.ts）的情况：同样适用，declarations会指向.d.ts中的声明节点。

内容的提问来源于stack exchange，提问作者Wickoo