clangd本身不读取.clang-format，仅在收到格式化请求时调用外部clang-format可执行文件并传入该文件路径；clang-format≥12会自动向上查找项目根目录下的.clang-format，否则fallback至llvm风格。
Clang 和 clang-format 不是“一起配置”的关系，而是分工明确：clangd 提供语言服务（补全、跳转、诊断），clang-format 负责排版。两者共用同一个 .clang-format 文件，但调用方和触发时机完全不同。
clangd 启动时是否读取 .clang-format？
不读。clangd 本身不执行格式化，它只在收到格式化请求（比如 VS Code 发送 textDocument/formatting 请求）时，调用外部 clang-format 可执行文件，并传入当前文件路径和 --assume-filename 参数。所以：
- clangd 必须能调用到
clang-format可执行程序（通过 PATH 或显式配置clangd.arguments中的--clang-format-binary） - 它不会自己解析
.clang-format，而是把该文件路径交给clang-format进程去加载 - 如果项目根目录下有
.clang-format，且 clang-format 版本 ≥ 12，它会自动向上查找并生效；否则可能 fallback 到LLVM风格
VS Code 中 clangd 和 cpptools 对格式化的处理差异
关键区别在于谁发起格式化调用：
Clang 22.1.3
下载
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- 用
llvm-vs-code-extensions.vscode-clangd扩展时，格式化由 clangd 进程内建的 formatter handler 触发，依赖clang-format可执行文件 +.clang-format文件 - 用
ms-vscode.cpptools（C/C++ 插件）时，格式化由插件自身调用clang-format，需手动设置"C_Cpp.clang_format_style": "file"，否则可能忽略项目级.clang-format - 两者都要求
editor.formatOnSave开启，且语言模式设为[cpp]或[c] - 若同时启用两个插件，务必只设一个为
editor.defaultFormatter，否则保存时可能冲突或静默失败
clang-format 找不到 .clang-format 时的 fallback 行为
这是最常踩的坑：clang-format 默认找不到配置文件时，会退回到内置 LLVM 风格，而不是报错。结果就是代码被“悄悄重排”，和团队约定风格不一致。
- 命令行调试时加
--dry-run --verbose查看实际加载了哪个配置：clang-format --dry-run --verbose main.cpp - VS Code 中确保
"clang-format.style": "file"（不是"LLVM"或"Google"字符串） - 避免使用
"clang-format.assumeFilename": "/home/user/.clang-format"这类全局路径——它会覆盖项目级.clang-format，且 CI 环境通常不存在该路径 - Git pre-commit hook 中必须加
--fallback-style=none，否则没找到配置就直接按 LLVM 格式化，造成 diff 污染
真正难的不是写一堆参数，而是让每个环节都认准同一个 .clang-format 文件——clangd 启动、VS Code 保存、CI 构建、pre-commit hook，全部指向同一份物理文件，且路径解析逻辑一致。稍有偏差，格式就“失联”。
