C 语言声明语法以其紧凑性和灵活性著称，但当涉及多层嵌套的指针、数组和函数指针时，往往成为 “乱码”，难以快速解析。传统工具如经典的 cdecl 仅提供英文描述，而 cdecl-dump 则创新性地将声明解析为树状图，在终端中直观展示结构层次。这种可视化方式特别适合调试遗留代码或设计复杂数据结构。
cdecl-dump 的核心是一个手写、表驱动的词法分析器和解析器。它将 C 声明的语法树渲染为 ASCII 艺术树图，从根节点（类型）向下展开指针、数组维度、函数签名等修饰符。树图使用分支线条清晰区分嵌套关系，避免了线性阅读的歧义。例如，对于简单声明 “int a”，输出仅显示基本类型节点；复杂者如指针到函数的数组，则层层展开。
实际使用前，先克隆仓库并构建。执行./build.sh生成调试版，支持解析阶段追踪；DEBUG=0 ./build.sh产出优化可执行文件。构建依赖标准 C 编译器，无额外库。安装后，直接运行./cdecl-dump "声明字符串"即可输出树图。
来看几个典型示例。首先，“unsigned char *const *arr [20][30]”：这是一个 20x30 二维数组，每个元素是指向 const 指针的指针，指向 unsigned char。树图根为 array [20][30]，分支到 pointer to const pointer to unsigned char，直观显示双重指针嵌套，避免混淆 “arr 是啥指向啥”。
另一个经典：“int (*const fp [20])(void)”。这是 20 个 const 函数指针数组，每个指针指向无参返回 int 的函数。树图从 array [20] of const pointer to function (void) returning int 展开，函数签名独立成子树，便于验证参数 / 返回类型。
对于函数声明 “void f (int a)”，树简化为 function f (int a) returning void，突出参数列表。
这种树状表示的优势在于可落地性：在 IDE 中集成脚本，或 CI 管道中验证头文件声明。参数方面，工具暂无额外选项，但调试版 TRACE 输出解析日志，有助于自定义扩展。
局限包括仅支持内置类型（如 int、char），不支持 typedef 或 struct；解析宽松，允许 C 标准禁止的如 “函数返回数组”，需人工校验。工程中，可结合 clang -ast-dump 作为互补，前者可视化后者文本树。
实践清单：
- 构建优化版：DEBUG=0 ./build.sh，确保性能。
- 测试复杂声明：优先指针 * 函数 () 数组 [] 组合。
- 监控解析：调试版下观察 TRACE，阈值 > 10 层嵌套报警。
- 集成 Vim/Emacs：alias 或插件调用，选中文本复制树图。
- 回滚策略：若解析失败，用经典 cdecl 英文描述兜底。
- 团队分享：GitHub issue 追踪新类型支持。
通过 cdecl-dump，C 声明从 “乱码” 转为 “树图”，加速理解与维护。未来若添 SVG 输出或交互缩放，将更强大。
资料来源：
- GitHub 仓库：https://github.com/bbu/cdecl-dump （主要）
- 相关讨论：https://news.ycombinator.com/item?id=41567890 （次要）