VSCode Clang代码自动格式化

针对Windows环境下Visual Studio Code的C/C++代码自动格式化。

C/C++扩展

在VSCode里安装C/C++扩展，扩展程序将自动安装Clang-Format。
在C/Cpp文件里可以通过Shift+Alt+F进行格式化；或者右键 - Format Document。

预定义样式

Ctrl+Shift+P输入user settings，进入Settings界面；或者菜单栏File - Preferences - Settings。
搜索clang。
Clang_format_fallback Style：预定义样式。在没有找到.clang-format文件情况下使用这里定义的样式。可以设置的值为：Visual Studio、LLVM、Google、Chromium、Mozilla、WebKit、none，或者{key: value，…}这样的键值对。
以下对比一下几种预定义样式。

自定义样式

Ctrl+Shift+P输入user settings，进入Settings界面；或者菜单栏File - Preferences - Settings。
搜索clang。
Clang_format_style：默认值是file，表示从当前目录或父目录中的.clang-format格式文件加载样式。
自定义样式的几个步骤：

• Win+R打开运行，输入powershell打开PowerShell。
• 输入cd C:\Users\<User Name>\.vscode\extensions\ms-vscode.cpptools-0.25.0\LLVM\bin进入到Clang工具所在目录。
• 输入 .\clang-format.exe -style="llvm" -dump-config > .clang-format可生成LLVM的样式文件.clang-format。
• 将样式文件.clang-format拷贝至当前目录或者父目录即可生效。
• 右键，使用记事本或者Notepad++等文本编辑工具打开，参照Clang 10文档可自定义格式化效果。

以下是我的自定义样式文件以及格式化效果。
VSCode C/C++ Clang自定义样式文件.clang-format

可能的错误

如果使用了自定义格式化却没有生效，点击VSCode左下角，查看OUTPUT的错误信息，右上角选择C/C++。

YAML:1:4: error: Got empty plain scalar
  ��-
 # 可能是文件编码问题。
 # 使用Notepad++打开，菜单栏 编码 - 使用UTF-8编码，保存。

  YAML:13:32: error: invalid boolean
  AllowShortBlocksOnASingleLine: Empty
                                 ^~~~~
  Error reading c:\Users\Woan-Development\Documents\Development\svn\Wo\WoSensorTH\trunk\src\.clang-format: invalid argument
 # 参数错误，可能是版本差异，根据生成样式文件时候的默认值去推断。
 # 前面的13指示错误行；32指示错误开始列。