Clang AST Visitor 的核心是继承 RecursiveASTVisitor 模板类并重载 Visit* 方法（如 VisitCallExpr），需 public 继承、模板参数为自身类型；通过自定义 ASTConsumer 和 FrontendAction 注册，调用 TraverseDecl/TraverseStmt 触发遍历，注意处理宏、隐式转换及多线程安全。
Clang AST Visitor 的核心是继承 RecursiveASTVisitor
你不需要手动遍历节点树，Clang 已经封装好递归逻辑；真正要做的，是继承 RecursiveASTVisitor 模板类，并重载你关心的节点访问函数（比如 VisitCallExpr、VisitBinaryOperator）。模板参数必须是你自己的 visitor 类型，否则编译会报错：「no matching function for call to …」。常见错误是忘记写 public RecursiveASTVisitor，或漏掉 public 继承——C++ 默认私有继承，导致基类接口不可见。
你的 visitor 类通常不需构造复杂状态，但建议加一个 bool shouldTraversePostOrder() const 返回 false（默认前序），避免某些场景下重复匹配；如果要收集所有匹配点，用 std::vector 成员变量存结果，别依赖全局或静态变量——多线程调用 AST consumer 时会出问题。
怎么注册 visitor 并让它跑起来：关键在 ASTConsumer 和 FrontendAction
visitor 本身不会自动触发，必须挂到 Clang 的处理流水线上。最简路径是写一个自定义 ASTConsumer，在 HandleTranslationUnit 里创建 visitor 实例并调用 TraverseDecl 或 TraverseStmt。注意：只调用 TraverseDecl 会漏掉函数体内的表达式；稳妥做法是先 TraverseDecl，再对每个 FunctionDecl 显式调用 TraverseStmt 其 getBody()。
然后需要一个 FrontendAction 子类，在 CreateASTConsumer 中返回你的 ASTConsumer。最后用 clang -Xclang -ast-dump 调试时看不到你的 visitor 输出，得自己编译成工具（如用 clangTool + ClangTool::run）或写个 main 函数调用 tooling::runToolOnCode 测试小片段。调试时加 printf 或 llvm::errs() 比日志库更直接。
匹配特定模式时，别只看节点类型，要检查子节点和语义信息
比如想抓「空指针解引用」，单靠 VisitUnaryOperator 不够——得判断操作符是否为 UO_Deref，再递归检查其子表达式是否为 NullPtrLiteralExpr 或恒为 null 的 DeclRefExpr（如未初始化的指针变量）。这时候要用 getReferencedDeclOfCXXBaseSpecifier 类似辅助函数，但更常用的是 IgnoreImpCasts() 和 IgnoreParenCasts() 去掉隐式转换干扰。
另一个典型坑：字符串字面量匹配。想识别 "foo" == "bar" 这种无意义比较，不能只查 VisitBinaryOperator 的 BO_EQ，还要确保左右都是 StringLiteral 类型，且用 getAsString() 取值——但注意 StringLiteral 的字符编码可能含 \0，getString().str() 更安全。还有宏展开问题：默认 visitor 不进宏体，需在 CompilerInstance 上设 setPreprocessorOptions 启用 IncludeInclusionDirectives，但这会让性能明显下降，慎开。
编译链接时最容易卡住的三个点
Clang AST 工具不是靠头文件就能跑的，必须链接正确的库。常见错误包括：
- 只链了
libclangAST.a却没链libclangBasic.a和libclangLex.a，导致SourceLocation或Token相关符号未定义 - CMake 中没设置
set(CMAKE_CXX_STANDARD 17)，而 Clang 头文件用了std::optional或std::string_view，编译直接失败 - 头文件路径没加全，尤其
clang/Tooling/Tooling.h和clang/Frontend/FrontendActions.h必须显式包含，且顺序不能颠倒（后者依赖前者）
建议从 clang/examples/PrintFunctionNames 示例开始改，而不是从零写；它的 CMakeLists.txt 已配好所有依赖项。另外，Clang 版本强耦合——用 Clang 16 编译的代码，基本没法直接迁移到 Clang 18，因为 RecursiveASTVisitor 的模板参数签名或内部字段可能微调过。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
