如何用Libclang Python绑定获取C++类/结构体的注解？

针对你遇到的问题：用clang.cindex解析AST时，结构体TestComponent的顶层__attribute__((annotate))注解无法通过get_children()获取，因为这些注解不属于节点的子节点，而是属于STRUCT_DECL节点的直接属性，需要通过属性接口来获取。

解决方案1：使用Python cindex内置属性接口（如果支持） #

如果你的clang版本较新，Python的cindex库已经封装了属性获取方法，可以直接遍历节点的属性筛选ANNOTATE类型：

import clang.cindex

def get_top_level_annotations(node):
    annotations = []
    # 遍历节点的所有属性
    for attr in node.get_attributes():
        if attr.kind == clang.cindex.CursorKind.ANNOTATE_ATTR:
            annotations.append(attr.displayname)
    return annotations

# 使用示例：当node是STRUCT_DECL类型时
# struct_annotations = get_top_level_annotations(struct_node)

解决方案2：直接调用Clang C API（猴子补丁实现） #

如果Python层没有封装属性接口，可以通过ctypes调用Clang的C API，给Cursor类打猴子补丁添加获取注解的方法：

import ctypes
import clang.cindex

# 加载Clang动态库，路径根据系统调整：
# Linux: "libclang.so"
# macOS: "/usr/lib/libclang.dylib"
# Windows: "C:/Program Files/LLVM/bin/libclang.dll"
libclang = ctypes.CDLL("libclang.so")

# 绑定Clang C API函数的类型
libclang.clang_getCursorAttributes.restype = ctypes.POINTER(ctypes.c_void_p)
libclang.clang_getCursorAttributes.argtypes = [clang.cindex.CXCursor, ctypes.POINTER(ctypes.c_uint)]
libclang.clang_getAttrKind.restype = ctypes.c_uint
libclang.clang_getAttrKind.argtypes = [ctypes.c_void_p]
libclang.clang_AnnotateAttr_getAnnotation.restype = clang.cindex.CXString
libclang.clang_AnnotateAttr_getAnnotation.argtypes = [ctypes.c_void_p]
libclang.clang_getCString.restype = ctypes.c_char_p
libclang.clang_getCString.argtypes = [clang.cindex.CXString]
libclang.clang_disposeString.argtypes = [clang.cindex.CXString]

# 定义获取结构体注解的方法
def get_struct_annotations(self):
    annotations = []
    count = ctypes.c_uint(0)
    # 获取当前节点的所有属性
    attrs = libclang.clang_getCursorAttributes(self, ctypes.byref(count))
    for i in range(count.value):
        attr = attrs[i]
        # 判断是否为ANNOTATE属性（CXAttrKind_AnnotateAttr枚举值需对应你的Clang版本，此处为27）
        if libclang.clang_getAttrKind(attr) == 27:
            cx_str = libclang.clang_AnnotateAttr_getAnnotation(attr)
            c_str = libclang.clang_getCString(cx_str)
            if c_str:
                annotations.append(c_str.decode("utf-8"))
            # 释放CXString资源
            libclang.clang_disposeString(cx_str)
    return annotations

# 给Cursor类猴子补丁添加方法
clang.cindex.Cursor.get_struct_annotations = get_struct_annotations

# 使用示例：
# struct_node = ... # 指向TestComponent的STRUCT_DECL节点
# annotations = struct_node.get_struct_annotations()
# print(annotations) # 输出: ["MyAttribute"]

注意事项 #

• CXAttrKind_AnnotateAttr的枚举值需根据你的Clang版本确认，可查看clang-c/Index.h头文件中的定义。
• 确保Clang动态库路径正确，不同系统和安装方式路径可能不同。

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