先确认已安装 clang-format 插件（如 xaver.clang-format）并配置可执行文件路径；保存自动格式化需在 settings.json 中为 [cpp] 语言显式启用 editor.formatOnSave 和 defaultFormatter；配置文件必须为 .clang-format（YAML 格式）且置于工作区根目录，避免使用 BasedOnStyle: file；.h 文件行为差异源于 clang-format 内置规则，可通过 IncludeIsMainRegex: '' 和 SortIncludes: false 统一。
clang-format 在 VS Code 中不生效？先确认插件和配置路径
VS Code 本身不自带 clang-format，必须装插件 + 有可执行文件。常见现象是右键“Format Document”没反应、保存不格式化、或报错 Failed to load module 'clang_format'。
- 装官方插件：
ms-vscode.cpptools（含基础支持）或独立插件xaver.clang-format（更轻量，推荐） -
clang-format可执行文件必须在系统 PATH 里，或手动指定路径：打开设置 → 搜索clang-format.executable→ 填绝对路径，比如/usr/bin/clang-format（macOS/Linux）或C:\Program Files\LLVM\bin\clang-format.exe（Windows） - 别用
clang-format@npm版本——它不兼容 VS Code 的 LSP 调用方式，会静默失败
如何让保存时自动格式化 C++ 文件
默认不开启，需显式启用并限定语言。只开全局格式化容易误伤 JS/Python 文件。
- 在
settings.json中加这段（不是用户设置界面点选，要手动编辑）：
"[cpp]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "xaver.clang-format"
}
- 如果用了
ms-vscode.cpptools，defaultFormatter应设为ms-vscode.cpptools，但它对.h文件的格式化行为和.cpp不一致，容易漏格式化头文件 - 确保没同时启用其他 C++ 格式化插件（比如
jeff-hykin.cpp-textmate-grammar），冲突会导致格式化被跳过
clang-format 配置文件怎么找、怎么写才管用
VS Code 不读取项目根目录下的任意命名配置文件，只认特定名字和位置。
- 优先级从高到低：
.clang-format（YAML 格式，推荐）→_clang-format（Windows 友好）→clang-format（无扩展名，不推荐） - 文件必须放在工作区根目录（即你用
File → Open Folder打开的那个文件夹），放子目录里无效 - 简单起见，直接生成一个最小可用配置：
clang-format -style=google -dump-config > .clang-format，然后删掉注释行，保留关键项如IndentWidth、UseTab - 别写
BasedOnStyle: file—— 它会尝试加载同目录下另一个配置，但 VS Code 插件不支持这个解析逻辑，直接忽略
为什么 .h 文件格式化效果和 .cpp 不一样
这是 clang-format 本身的规则差异，不是 VS Code 配置问题。头文件默认启用 IncludeIsMainRegex 和 SortIncludes 等头文件专属规则。
立即学习“C++免费学习笔记（深入）”；
- 如果你希望 .h 和 .cpp 行为一致，可以在
.clang-format中强制关闭头文件特化逻辑：
IncludeIsMainRegex: '' SortIncludes: false
- 但注意：关掉
SortIncludes后，#include顺序不会自动整理，多人协作时容易出风格分歧 - 另一个坑：某些项目用
INCLUDE_DIRECTIVE自定义 include 规则，clang-format 14+ 才支持，旧版会直接跳过整个 include 块
真正麻烦的是跨平台路径分隔符和编码：Windows 下用 CRLF 写的 .clang-format，在 WSL 或 Linux 里可能因换行符解析失败，导致整个配置被忽略——遇到格式化突然失效，先检查文件是否是 LF 结尾。
