扩展名为 C/C++ 的 VSCode 中多行注释的错误缩进

Question

似乎 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}

我是否遗漏了样式参数，或者这是格式化程序中的错误？

Answer 1

问题出在 ColumnLimit: 0。这以某种方式禁用了 non-first-line-part of multi-line 注释的缩进。（这似乎在任何地方都没有记录——我认为这是一个错误。）最好的解决方法可能是将 ColumnLimit 设置为某个合理的 non-zero 值。

Wrong indentation of multiline comments in VSCode with C/C++ extension