使用clang Python绑定遇Unknown template argument kind 604的解决办法

问题背景 #

使用python-clang 15版本处理C++20 Concept时，触发以下错误：

ValueError: Unknown template argument kind 604

运行命令：
-std=c++20 <input file>

使用的代码如下：

import clang.cindex

def visit_nodes(node, src_file, depth):
    if node.location.file == None or node.location.file.name == src_file:
        for i in range(0, depth):
            print('    ', end = '')
        print('%s %s'%(node.kind, node.spelling))

        for child in node.get_children():
            visit_nodes(child, src_file, depth + 1)

def load_symbols(src_file, compiler_options = None):
    index = clang.cindex.Index.create()
    translation_unit = index.parse(src_file, compiler_options)
    visit_nodes(translation_unit.cursor, src_file, 0)

if __name__ == '__main__':
    import sys
    if len(sys.argv) < 2:
        exit(1)
    load_symbols(sys.argv[-1], sys.argv[1:-1])

原因分析 #

这个错误确实是python-clang 15的功能缺失导致的。Clang 15本身已支持C++20 Concept，但python-clang的绑定代码未同步更新TemplateArgumentKind枚举，缺失了值为604的类型（大概率对应Concept相关的枚举项）。

解决方案 #

1. 手动临时修复（无需等待新版本） #

可以手动扩展python-clang的枚举定义来支持该类型：

• 找到python-clang安装目录下的cindex.py文件
• 定位到TemplateArgumentKind枚举类，添加缺失的枚举项：

  class TemplateArgumentKind(Enumeration):
      # ... 保留已有枚举项 ...
      CONCEPT = 604  # 可根据实际语义调整命名
  

• 保存文件后重启Python环境，重新运行代码

另外，可在遍历节点时添加异常捕获，避免程序直接崩溃：

def visit_nodes(node, src_file, depth):
    if node.location.file == None or node.location.file.name == src_file:
        for i in range(0, depth):
            print('    ', end = '')
        print('%s %s'%(node.kind, node.spelling))

        for child in node.get_children():
            try:
                visit_nodes(child, src_file, depth + 1)
            except ValueError as e:
                if "Unknown template argument kind 604" in str(e):
                    # 自定义处理逻辑，比如打印占位信息
                    for i in range(0, depth + 1):
                        print('    ', end = '')
                    print('UNKNOWN_TEMPLATE_ARGUMENT_KIND_604')
                else:
                    raise

2. 升级到更高版本 #

如果不愿手动修改，等待python-clang后续版本（如16及以上）即可，新版本通常会同步Clang的枚举定义，修复这类C++20特性支持的问题。

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