如何获取属性CXCursor的AST父节点及clang_visitChildren回调中的父游标？

问题分析 #

你遇到的情况是Clang AST遍历中的典型问题：在clang_visitChildren递归遍历过程中，能看到visibility属性游标直接依附于函数声明节点，但单独调用clang_getCursorSemanticParent或clang_getCursorLexicalParent获取该属性游标父节点时，却返回CXCursor_InvalidFile。这是因为Clang对属性节点的父节点处理有特殊逻辑——属性属于依附于声明的附加节点，语义/词法父节点接口不会直接返回其所属的声明，反而会因属性节点的特殊定位返回无效游标。

解决方案 #

方法1：遍历过程中直接使用传入的父游标 #

最可靠的方式是在clang_visitChildren的回调函数中，直接利用Clang传入的父游标处理子节点，完全避开属性节点父接口的坑：

CXChildVisitResult visitor(CXCursor child, CXCursor parent, CXClientData client_data) {
    if (clang_getCursorKind(child) == CXCursor_VisibilityAttr) {
        // 这里的parent就是属性对应的函数声明游标
        CXString attrName = clang_getCursorSpelling(child);
        CXString parentName = clang_getCursorSpelling(parent);
        printf("属性%s的父节点：%s\n", clang_getCString(attrName), clang_getCString(parentName));
        clang_disposeString(attrName);
        clang_disposeString(parentName);
    }
    return CXChildVisit_Recurse;
}

调用遍历的代码示例：

// targetCursor为要遍历的根节点，比如翻译单元或函数声明
clang_visitChildren(targetCursor, visitor, NULL);

方法2：通过属性依附的声明获取父节点 #

如果必须单独处理属性游标（非遍历过程中拿到的），可以调用clang_getCursorReferenced获取属性依附的声明，这个声明就是目标父节点：

CXCursor attrCursor = ...; // 已定位的visibility属性游标
CXCursor attachedDecl = clang_getCursorReferenced(attrCursor);
if (clang_getCursorKind(attachedDecl) == CXCursor_FunctionDecl) {
    // attachedDecl即为对应的函数声明父节点
}

该方法仅对依附于声明的属性有效，visibility属性刚好属于这类场景。

常规父节点接口失效的原因 #

Clang的属性节点在AST中属于"隐式"附属节点，没有独立的词法/语义父节点链，仅作为声明的附加信息存在。clang_getCursorSemanticParent和clang_getCursorLexicalParent主要针对有明确语法位置的节点，属性节点不符合该条件，因此返回无效游标。

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