似乎 C/C++ 扩展的 clang 格式化程序在缩进多行注释时有困难。
使用格式化程序时,我得到以下格式(因此只有第一行的格式正确(:
/**
* @brief Does cool stuff
*
* @param param1
* @returns myresult
*/
bool myFunction(bool param1);
但是,我希望格式为:
/**
* @brief Does cool stuff
*
* @param param1
* @returns myresult
*/
bool myFunction(bool param1);
我的 VSCode Clang 格式样式:
{BasedOnStyle: Google, IndentWidth: 3, ColumnLimit: 0, NamespaceIndentation: All, AlignTrailingComments: true}
我是否缺少样式参数,或者这是格式化程序中的错误?
问题出在ColumnLimit: 0
上。这以某种方式禁用了多行注释的非第一行部分的缩进。(这似乎没有在任何地方记录 - 我认为这是一个错误。最好的解决方法可能是将ColumnLimit
设置为某个合理的非零值。