如何让clang-format将构造函数初始化列表元素单独换行？

你碰到的这个问题确实是clang-format当前配置的一个小痛点——现有的ConstructorInitializerAllOnOneLineOrOnePerLine选项只会在初始化列表长度超出ColumnLimit时，才会把每个初始化项拆成单独一行，没法强制在没达到行宽限制的时候就保持每行一个元素的格式。

为啥现有配置没效果？ #

你调整AllowShortBlocksOnASingleLine完全没用是正常的，因为这个选项管控的是代码块（比如{}包裹的内容），和构造函数的初始化列表根本不搭边。而你当前设置的ConstructorInitializerAllOnOneLineOrOnePerLine: false，再加上BreakConstructorInitializers: AfterColon，clang-format会尽可能把所有初始化项挤在一行，直到超过列限制才会换行拆分。

临时的替代思路 #

目前clang-format还没有直接的枚举选项来强制每行一个初始化元素，不过有两个不太完美的临时办法：

• 故意把ColumnLimit设得极小，比如设成20，这样哪怕很短的初始化列表也会触发换行，但这会影响整个代码库的其他代码格式化，显然不太实用。
• 如果用的是clang-format 15及以上版本，可以试试把BreakConstructorInitializers改成BeforeComma，同时把ConstructorInitializerAllOnOneLineOrOnePerLine设为true。这个设置会让clang-format在需要换行时，把每个初始化项单独放在一行，但如果你的初始化项本身特别短，还是会挤在一行里。

官方的局限与改进建议 #

正如你注意到的，ConstructorInitializerAllOnOneLineOrOnePerLine的设计逻辑就是“能塞一行就塞一行，塞不下才拆分”。目前这个选项还没有扩展成枚举类型（比如增加ForceOnePerLine这种强制换行的取值），如果这个需求对你很重要，可以考虑在LLVM的官方issue tracker上提交功能请求，不过得等官方迭代支持。

尝试调整的配置示例 #

如果想尽可能接近你要的效果，可以修改这两个参数：

BreakConstructorInitializers: BeforeComma
ConstructorInitializerAllOnOneLineOrOnePerLine: true

还是要提醒一下，这个配置没法强制短初始化列表拆分行，只是在有换行需求时会保持每行一个元素的格式。

内容的提问来源于stack exchange，提问作者ivan.ukr