Clang-Format 仅在手动触发、保存文件（需启用 formatOnSave 且语言模式为 cpp/c）或显式调用时生效，不挂钩编译或运行流程；“运行前对齐”需靠保存即格式化实现，而非 tasks.json 或 launch 配置。
Clang-Format 不会在代码“运行前”执行对齐 —— 它只在格式化触发时工作，和编译、调试、运行完全无关。所谓“运行前强制对齐”，本质是把格式化动作绑定到保存或构建流程中，靠人为约定达成效果。
Clang-Format 的触发时机只有三种
它不是编译器插件，也不挂钩 g++ 或 clang++ 的编译流水线，更不会在你点 ▶️ 运行按钮时自动跑一遍。它的实际生效路径只有：
- 手动按
Shift+Alt+F（或右键 → “格式化文档”） - 保存文件时，且
editor.formatOnSave为true，且当前语言模式（右下角）是cpp或c - 通过 VSCode 的
editor.codeActionsOnSave配置显式调用source.formatDocument
如果你期望“每次 F5 启动调试前都自动对齐”，VSCode 原生不支持；必须靠任务（tasks.json）或 launch 配置间接实现，但会引入延迟和失败风险。
想让对齐“看起来像运行前发生”，只能靠保存即格式化
这是最稳定、最低侵入的做法。关键不是改运行逻辑，而是让保存行为成为事实上的“提交前检查点”：
- 确保
"editor.formatOnSave": true已启用（全局或工作区） - 确认
"[cpp]": { "editor.defaultFormatter": "ms-vscode.cpptools" }，否则 C/C++ 文件根本不会走 clang-format 流程 -
C_Cpp.clang_format_style必须设为file，且项目根目录存在有效的.clang-format文件——否则所有对齐参数（如AlignConsecutiveAssignments）都被忽略 - 避免和 Prettier、ESLint 等同时设为默认 formatter；冲突时 VSCode 只用一个，顺序不可控
示例最小有效配置片段（.vscode/settings.json）：
{
"editor.formatOnSave": true,
"[cpp]": {
"editor.defaultFormatter": "ms-vscode.cpptools"
},
"C_Cpp.clang_format_style": "file"
}
别碰 tasks.json 做“运行前对齐”的陷阱
有人试图在 tasks.json 里加一条 clang-format -i *.cpp 作为前置任务，再让 launch 依赖它。这看似合理，实则问题一堆：
- 匹配不到头文件（
*.h）或特定子目录，对齐不完整 - 格式化失败（比如语法错误）会导致整个构建中断，误判为编译失败
- VSCode 任务不感知编辑器光标位置，无法只格式化当前修改的文件，容易污染未改动代码
- 多文件并行保存时，task 触发时机与编辑器保存事件不同步，出现“刚对齐又被覆盖”
真正需要构建时强约束的团队，应该把 clang-format --dry-run 放进 CI 流水线做门禁，而不是塞进本地 launch 流程。
对齐参数生效的前提经常被忽略
即使你写了 AlignTrailingComments: true 和 AlignConsecutiveAssignments: true，它们也只在 clang-format 实际接管格式化时才起效。常见静默失效原因：
- 右下角语言模式显示
Plain Text或JSON，不是cpp—— clang-format 直接跳过 -
C_Cpp.clang_format_path指向了不存在的路径，或二进制无执行权限，VSCode 回退到内置基础格式化（无对齐能力） -
.clang-format文件放在子目录而非工作区根目录，clang_format_style: file找不到它 - 用了
clang_format_fallbackStyle: "Google"，所有自定义对齐字段全被覆盖
验证是否真正在用你的配置：打开命令面板（Ctrl+Shift+P），运行 Clang-Format: Show Current Style —— 它会输出最终解析后的全部参数，一眼就能看出对齐项有没有被加载。
