如何让clang-format始终将函数声明/定义的参数各占一行？

要实现无论函数长度是否超过列宽，始终将每个参数单独占一行的格式，你需要在.clang-format配置文件中设置以下关键选项：

核心配置项 #

BasedOnStyle: LLVM
AlignAfterOpenBracket: AlwaysBreak  # 括号后强制换行
BinPackParameters: false            # 禁止将多个参数打包到同一行
BreakBeforeBraces: Allman           # 大括号单独占一行（适配源文件函数定义格式）
IndentWidth: 4                      # 缩进4个空格（可按需调整）
ColumnLimit: 0                      # 关闭列宽限制，确保强制换行不受列宽影响

配置解释 #

• AlignAfterOpenBracket: AlwaysBreak：强制函数名后的左括号结束后立即换行，所有参数从新行开始缩进。
• BinPackParameters: false：明确禁止将多个参数合并到同一行，确保每个参数单独占一行。
• BreakBeforeBraces: Allman：让函数定义的大括号单独位于新行，匹配你需要的源文件格式；头文件中的函数声明会自动保留分号在最后一行末尾。
• ColumnLimit: 0：关闭列宽检查，彻底避免因函数总长度较短而被clang-format自动合并为一行的情况。

效果验证 #

头文件（.h）格式化后： #

void myFunc(
    int a,
    int b,
    int c);

源文件（.cpp）格式化后： #

void myFunc(
    int a,
    int b,
    int c)
{
    // do something here
}

若需调整缩进空格数，修改IndentWidth的值即可（比如改成2）。

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