如何使用Clang Format在函数间添加自定义分隔符？

Clang Format本身不直接支持自动插入自定义分隔符注释，但可以通过两种可行方案达成需求：

• 脚本+Clang Format配置组合方案

  1. 用脚本遍历代码库，在每个函数定义前插入特定标记注释，比如// FUNC_SEP；
  2. 在项目的.clang-format配置文件中添加规则：CommentPragmas: '^// FUNC_SEP$'，确保Clang Format不会修改或删除这个标记；
  3. 再次用脚本将所有// FUNC_SEP替换为目标分隔符：//-----------------------------------------------------------------------------。

• 自定义Clang Tooling工具方案
  基于Clang的LibTooling编写轻量工具，通过遍历AST（抽象语法树）精准识别函数定义节点，在每个函数（除文件内第一个函数）的上方插入指定分隔符注释，之后再用Clang Format格式化代码保证格式统一。

提示：大型代码库更推荐第二种方案，脚本方案可能存在边界识别误差（比如类成员函数、静态函数的特殊场景）。

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