clang-format 是唯一能真实对齐 c/c++ 行尾 // 注释的工具，需配置 aligntrailingcomments: true 且 columnlimit: 0，并安装 c/c++ 与 clang-format 扩展；prettier 和 editorconfig 均不支持注释位置控制。
Clang-Format 对齐 C/C++ 行尾注释必须配 AlignTrailingComments
VSCode 内置格式器对 // 注释位置完全无感，只有 clang-format 能真实按列插入空格实现垂直对齐。关键配置项是 AlignTrailingComments，且必须搭配 ColumnLimit: 0 ——否则一旦某行超长，它会主动放弃对齐逻辑，导致部分行对不齐。
需同时安装两个扩展：C/C++（Microsoft 官方）和 Clang-Format（xaver.clang-format）。在 .vscode/settings.json 中写入：
"C_Cpp.clang_format_fallbackStyle": "{AlignTrailingComments: true, ColumnLimit: 0}"
- 只作用于单行
//注释，/* */块注释不受影响 - 若项目已启用 Prettier，务必在
settings.json中为cpp和c文件类型单独指定默认 formatter，避免冲突 -
ColumnLimit: 0是硬性要求，设成120或其他值都会触发折行逻辑，破坏对齐效果
Prettier 不处理注释位置，别白费力气配 trailingComma 或 semi
prettier 的设计原则是“消除风格争议”，它明确放弃控制注释的水平位置。无论你改 printWidth、加 tabWidth，甚至写自定义插件，它都不会移动 // 后面的文字。
常见误操作包括在 .prettierrc 里加 "trailingComma": "all" 或调整 semi，这些和注释对齐完全无关。如果你用 Prettier 处理 JS/TS，又需要对齐注释，只能额外装 Comment Align 这类专用插件，且仅支持手动触发（选中多行 → 右键 → Align Comments）。
- 不要指望
prettier自动对齐，它连//前的空格数都不碰 - 多个格式化器共存时，必须用
"[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }显式限定语言作用域 - 保存后注释错位？先检查是否启用了多个 formatter，再确认
prettier.requireConfig: true是否开启
Doxygen 注释模板靠 VSCode 代码片段一键生成
结构化注释（如 Doxygen 风格）没法靠格式化工具生成，必须用 VSCode 的 code snippets 功能预置模板。比如 C/C++ 函数注释可定义前缀 docf，输入后自动展开为：
/**\n * @brief \n * \n * @param \n * @return \n */
配置路径：Ctrl+Shift+P → “Configure User Snippets” → 选 C 或 C++ → 粘贴 JSON 片段。注意 prefix 值要简短易记，body 中的换行和缩进需用 \n 和 \t 显式表达。
- 头文件和源文件的版权头模板也建议做成 snippet，避免每次手敲
- 团队共用时，把 snippets 放进项目级
.vscode/snippets/目录并提交 Git，而非用户级配置 - Doxygen 识别的是
/**和///，/*!兼容性差，不推荐
EditorConfig 控制基础缩进，但管不了注释内容
.editorconfig 能统一 indent_style、indent_size、end_of_line 等底层编辑行为，但它不解析注释语法，也不干预注释文字的位置或格式。
典型配置：
root = true\n[*]\ncharset = utf-8\nindent_style = space\nindent_size = 4\nend_of_line = lf\ninsert_final_newline = true
- 它让所有编辑器对 Tab/Space 的理解一致，但不会帮你把
// init flag拉到第 40 列 - 如果项目同时用
prettier和editorconfig，务必禁用prettier的tabWidth类规则，否则会冲突 -
.editorconfig必须提交 Git，否则新成员 clone 后根本读不到
真正稳定的注释对齐只发生在 C/C++ + clang-format 场景；其他语言要么靠手动插件，要么接受注释位置“随缘”。不同语言后端格式器能力差异太大，强行用一套配置覆盖全部，大概率导致保存失败或格式错乱。
