0Pricing
TypeScript Academy · 课时

使用访问器遍历 AST

遍历语法树节点以分析代码结构

使用访问器遍历 AST 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 2 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。

什么是 AST?

TypeScript 会将源代码解析为抽象语法树(AST),这是一棵由节点组成的树,用于表示变量、函数和表达式等语言结构。

import ts from "typescript";
const sf = ts.createSourceFile(
  "example.ts",
  "const x = 1;",
  ts.ScriptTarget.Latest
);

节点种类

每个 AST 节点都有一个 kind 属性(其值为 ts.SyntaxKind 枚举值),用于指示该节点表示的内容。

import ts from "typescript";
// Common kinds:
// ts.SyntaxKind.VariableDeclaration
// ts.SyntaxKind.FunctionDeclaration
// ts.SyntaxKind.Identifier

使用 forEachChild 进行访问

ts.forEachChild(node, visitor) 会针对节点的每个直接子节点调用您的访问器。使用递归即可遍历完整的树。

function visit(node: ts.Node) {
  if (ts.isFunctionDeclaration(node)) {
    console.log("Function:", node.name?.text);
  }
  ts.forEachChild(node, visit);
}
visit(sourceFile);

类型守卫函数

TypeScript 提供了 ts.isVariableDeclaration 和 ts.isFunctionDeclaration 等类型守卫函数,用于安全地收窄节点类型。

ts.forEachChild(sf, node => {
  if (ts.isClassDeclaration(node)) {
    console.log("Class:", node.name?.getText());
  }
  if (ts.isInterfaceDeclaration(node)) {
    console.log("Interface:", node.name.getText());
  }
});

获取节点文本

使用 node.getText(sourceFile) 获取节点的精确源文本,或使用包含琐碎内容的 node.getFullText()。

ts.forEachChild(sf, node => {
  if (ts.isIdentifier(node)) {
    console.log("Id:", node.text);
  }
});

节点位置

每个节点都有 pos 和 end 位置(字符偏移量),您可以利用它们在源代码中定位节点。

ts.forEachChild(sf, node => {
  console.log(node.kind, "at", node.pos, "-", node.end);
});

使用递归辅助函数遍历

常见的实用工具是一个 walk 函数,它会递归地对树中的每个节点应用访问器。

function walk(node: ts.Node, visitor: (n: ts.Node) => void) {
  visitor(node);
  ts.forEachChild(node, child => walk(child, visitor));
}

查找所有函数调用

使用递归遍历来查找源文件中的所有调用表达式——这对于检测接口使用情况很有用。

walk(sf, node => {
  if (ts.isCallExpression(node)) {
    const expr = node.expression.getText(sf);
    console.log("Call:", expr);
  }
});

访问父节点

默认情况下,AST 节点没有指向父节点的指针。调用 ts.setParent(sourceFile),或者使用 program.getSourceFile;后者会自动为程序设置父节点。

// For manually created source files:
// (ts as any).setParents(sf);

结合节点使用类型检查器

结合 AST 遍历和类型检查器,解析任意表达式节点的 TypeScript 类型。

const checker = program.getTypeChecker();
walk(sf, node => {
  if (ts.isExpression(node)) {
    const type = checker.getTypeAtLocation(node);
    console.log(checker.typeToString(type));
  }
});

回顾:AST 遍历

使用 forEachChild 和类型守卫函数遍历 TypeScript AST。将其与类型检查器结合,可构建功能强大的静态分析和代码生成工具。

快速检查

在 TypeScript AST 中递归访问子节点的函数是哪个?

您学到的内容

AST 遍历使用 ts.forEachChild 加上类型守卫函数来遍历并检查 TypeScript 文件中的每个节点。与类型检查器结合后,它可以支持代码检查器、代码分析器和重构工具。

常见问题解答

「使用访问器遍历 AST」课时是免费的吗?

是的 — 「使用访问器遍历 AST」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 TypeScript Academy 课程的其余内容,请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。

「使用访问器遍历 AST」这节课中我会学到什么?

遍历语法树节点以分析代码结构 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 2 节课,共 4 节。

「使用访问器遍历 AST」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗?

能。每节 TypeScript Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 使用 API 创建 TypeScript 程序
  2. 使用访问器遍历 AST
  3. 自定义转换器与代码生成
  4. 构建简单的代码检查工具
← 返回 TypeScript Academy