本文共 1065 字，大约阅读时间需要 3 分钟。

Clang-Format配置指南

安装

在 VS Code中安装 C/C++ 扩展程序，扩展程序会自动安装 clang-format。

安装步骤

配置首选项

配置生效快捷键

• 当前文件全文格式化：Shift + option + F
• 选择块格式化：Command + K 或 Command + F

配置格式化主题

基于某一主题上的修改

• 主题名称：可选Visual Studio、LLVM、Google、Chromium、Mozilla、WebKit、none或自定义主题。
• 自定义样式参考：

{
  "BasedOnStyle": "Google",
  "IndentWidth": 4,
  "IndentCaseLabels": false,
  "AccessModifierOffset": -4,
  "AlignTrailingComments": true
}

常用配置项

• 语言：C/C++
• 基于某一主题上的修改：Google
• 缩进宽度：4
• 缩进case标签：false
• 访问说明符偏移：-4
• 尾随注释对齐：true
• 函数参数位置：false
• 短if语句对齐：false
• 短循环对齐：false
• 包括排序：true

更多配置项参考：

• ColumnLimit：80
• AllowShortLoopsOnASingleLine：false
• AllowShortIfStatementsOnASingleLine：true
• AlignConsecutiveAssignments：true

配置格式化形式

基于某一主题上的修改

默认是 file，将会调用当前工程下的 .clang-format 文件。

生成主题文件

如果未安装 clang-format，请先执行 brew install clang-format。

生成主题文件：

clang-format -style=Google -dump-config > .clang-format

配置文件保存时自动格式化

• 按下 Command + S 保存文件时，或者关闭当前文件编辑，将会触发自动格式化代码。

配置行末加 ; 时自动格式化

类似 Xcode，一条语句后加分号，将会自动触发自动格式化代码。

以上配置项可以根据实际需求进行调整，建议参考 clang-format 官方文档获取更多信息。