VSCode中统一C++代码风格需配置Clang-Format：安装C/C++与Clang-Format扩展；设置clang-format.executable路径；项目根目录添加.clang-format文件；启用editor.formatOnSave和C_Cpp.formatting；支持命令面板动态切换样式。
如果您在使用 VSCode 编辑 C++ 项目时发现代码缩进、空格、换行等格式不一致，可能是 Clang-Format 未正确配置或未生效。以下是实现 C++ 代码风格统一的多种配置与应用方法：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装并启用 Clang-Format 扩展
Clang-Format 功能依赖于 VSCode 官方扩展提供语言支持与格式化触发能力，需先确保扩展已安装且处于激活状态。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X）。
立即学习“C++免费学习笔记（深入）”；
2、在搜索框中输入 C/C++，安装由 Microsoft 发布的官方扩展。
3、再次搜索 Clang-Format，安装由 xaverh named 的扩展（ID: xaverh.vscode-clang-format）。
4、重启 VSCode，确保扩展加载完成。
二、配置全局 Clang-Format 可执行路径
VSCode 需明确知道本地 Clang-Format 工具的安装位置，否则无法调用格式化功能。该路径必须指向可执行的 clang-format 二进制文件。
1、在终端中执行 which clang-format，确认其路径（如 /opt/homebrew/bin/clang-format）。
2、打开 VSCode 设置（Cmd+,），搜索 clang-format.executable。
3、点击编辑设置 JSON，在 settings.json 中添加如下行：
"clang-format.executable": "/opt/homebrew/bin/clang-format"
三、创建项目级 .clang-format 配置文件
通过本地配置文件可精确控制缩进宽度、括号风格、空格规则等细节，优先级高于全局设置，适用于多团队协作项目。
1、在项目根目录下新建文件，命名为 .clang-format（注意开头为英文点号）。
2、写入标准配置项，例如：
BasedOnStyle: Google
IndentWidth: 4
TabWidth: 4
UseTab: Never
BreakBeforeBraces: Attach
AllowShortIfStatementsOnASingleLine: false
四、绑定格式化快捷键并设置保存时自动格式化
手动触发格式化效率较低，启用保存即格式化可保障每次提交前代码风格自动对齐，避免遗漏。
1、打开命令面板（Cmd+Shift+P），输入 Preferences: Open Settings (JSON)。
2、在 settings.json 中添加以下两项：
"editor.formatOnSave": true
"C_Cpp.formatting": "clangFormat"
3、验证快捷键：选中一段 C++ 代码，按 Cmd+Shift+I，观察是否立即重排格式。
五、使用命令面板选择不同格式化样式
同一项目可能需临时切换风格（如审查 Google 风格 vs LLVM 风格），Clang-Format 支持运行时动态指定样式参数。
1、打开命令面板（Cmd+Shift+P），输入 Clang-Format: Select Style。
2、从下拉列表中选择 Google、LLVM、Microsoft 或 Chromium 等内置样式。
3、当前文件将立即按所选样式重新格式化，无需修改配置文件。
