如何配置clang-format仅为空函数/控制语句的大括号换行？

要实现你需要的效果，需组合使用clang-format的多个配置项，具体如下：

核心配置项说明 #

• BraceWrapping：控制大括号换行逻辑的核心，需针对不同语句类型设置规则
• AllowShortBlocksOnASingleLine：设为Never，确保空块不会和条件/函数声明在同一行
• AllowShortFunctionsOnASingleLine：设为None，避免空函数体和函数头同行

完整配置示例 #

将以下内容写入你的.clang-format文件：

Language: Cpp
BasedOnStyle: LLVM
AllowShortBlocksOnASingleLine: Never
AllowShortFunctionsOnASingleLine: None
BraceWrapping:
  AfterControlStatement: true
  AfterFunction: true
  EmptyFunctionBody: "new_line"
  EmptyLoopBody: "new_line"
  EmptyConditionals: "new_line"

配置效果验证 #

• 非空体的控制语句/函数保持正常格式：

if (true) {
   // not empty
}

void func() {
   // no empty
}

• 空体的控制语句/函数自动换行：

if (true) // empty
{}

void func() // empty
{}

注意：若你的clang-format版本较旧，部分配置项可能不支持，建议升级到12及以上版本以确保所有配置生效。

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