如何配置clang-format优先换行参数列表而非尾返回类型

要让clang-format优先对函数参数列表换行（而非折返回值箭头），同时支持空参数列表的换行需求，你需要调整以下几个关键配置项：

核心配置修改 #

在你的.clang-format文件中修改或添加以下内容：

# 降低在第一个参数前换行的惩罚，优先选择在左括号后换行
PenaltyBreakBeforeFirstCallParameter: 0
# 降低返回值单独换行的惩罚，避免优先折返回值箭头
PenaltyBreakReturnTypeOnItsOwnLine: 100
# 允许空参数列表在函数名过长时换行到下一行
AllowEmptyParameterDeclarationOnNextLine: true
# 尽量将参数打包在同一行，仅当超过行宽时才拆分每个参数
BinPackParameters: true

配置项说明 #

1. PenaltyBreakBeforeFirstCallParameter
   原配置为19，改为0后消除了在左括号后换行的惩罚成本，让clang-format更倾向于将参数列表整体换行到下一行，而非在返回值箭头处折行。

2. PenaltyBreakReturnTypeOnItsOwnLine
   原配置为1000000（极高惩罚），clang-format会尽量避免将返回值箭头折行，但实际计算中它认为折返回值的代价仍低于换行参数列表。降低为100后，clang-format会优先选择换行参数列表来满足行宽限制。

3. AllowEmptyParameterDeclarationOnNextLine
   原配置未显式设置（默认false），开启后当超长函数名导致整个声明超过行宽时，空参数列表会被换行到下一行，匹配你期望的空参数格式。

4. BinPackParameters
   原配置为OnePerLine，改为true后，clang-format会尽量将参数打包在同一行；只有当参数列表长度超过行宽限制时，才会将每个参数单独换行，完全匹配你期望的第三、第四个函数的格式。

修改后的效果验证 #

应用上述配置后，你的代码会被格式化为：

auto func(int a, int b, int c, int d, int e, int f, int g, int h, int i, int j) -> bool;
auto func(
    int a, int b, int c, int d, int e, int f, int g, int h, int i, int j, int k
) -> bool;
auto func(
    int a, int b, int c, int d, int e, int f, int g, int h, int i, int j, int k, int l
) -> bool;
auto func(
    int a,
    int b,
    int c,
    int d,
    int e,
    int f,
    int g,
    int h,
    int i,
    int j,
    int k,
    int l,
    int m
) -> bool;

auto fuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuunc() -> bool;
auto fuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuunc(
) -> bool;

完全符合你的期望格式。

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