如何配置Clang-format实现指定C/C++函数签名格式？或寻替代格式化工具

Clang-format相关配置 #

能否实现目标格式？ #

Clang-format无法通过现有配置项完全实现你要求的函数签名格式。它的内置逻辑会将函数名与左圆括号绑定，没有配置项能强制拆分两者并让左括号单独成行；虽然可以拆分参数、让左大括号单独成行，但核心的函数名-左括号换行需求无法满足。

如何让Clang-format不修改函数签名？ #

有两种可靠方式：

• 使用注释标记跳过格式化：在函数签名前后分别添加// clang-format off和// clang-format on，让Clang-format跳过该段内容的处理，示例如下：

// clang-format off
void my_func
(
    int arg1,
    char arg2
)
// clang-format on
{
    /*...*/
}

• 调整配置减少改动：设置BreakBeforeBraces: Allman、AllowAllParametersOfDeclarationOnNextLine: false，但这种方式无法完全阻止Clang-format调整函数名与括号的位置，仅能减少改动，不如注释跳过方式可靠。

可满足需求的其他格式化工具 #

Uncrustify #

可以通过配置文件完全匹配你的格式要求，关键配置项如下：

nl_func_def_start_line = force    # 强制函数名后换行，左括号单独成行
nl_func_args = force              # 每个参数单独占一行
nl_func_endparen = force          # 右括号单独占一行
nl_brace_fun = force              # 函数体左大括号单独成行

配置完成后，格式化后的代码会完全符合你给出的示例。

Artistic Style (astyle) #

通过命令行参数组合可以实现目标格式，执行命令时添加以下参数：

astyle --style=allman --break-closing-brackets --break-parameters=all --pad-first-paren-out your_code.cpp

各参数作用：

• --style=allman：函数体左大括号单独成行
• --break-closing-brackets：右圆括号单独成行
• --break-parameters=all：每个函数参数单独占一行
• --pad-first-paren-out：函数名与左圆括号之间添加换行

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