VSCode 的 Shift+Alt+A 仅执行纯文本包裹，不解析语法或调整缩进；块注释的对齐、嵌套、格式化依赖语言服务器或专用格式化器，而非编辑器内置功能。
VSCode 本身不支持块注释（/* */）的自动对齐或嵌套解析，所谓“自动对齐”只存在于行尾单行注释（//）场景，且必须依赖 clang-format；而块注释的缩进、换行、嵌套识别，全由所选格式化器决定，不是编辑器内置能力。
为什么 Shift+Alt+A 插入的 /* */ 不会自动缩进或对齐？
VSCode 的 Shift+Alt+A 是纯文本包裹操作：它只在选中代码首尾插入 /* 和 */，不做任何结构分析。不会判断是否跨行、是否嵌套、是否需缩进——它甚至不检查中间有没有已存在的 /* */，直接套一层，容易产生非法嵌套（如 /* /* inner */ outer */），C/C++/Java 编译器会报错。
-
Shift+Alt+A是“包裹式注释”，不是“格式化式注释” - 它不读取语言语法树，不识别注释边界，也不调整内部缩进
- 若选中代码本身缩进混乱，包裹后
/*和*/位置不对齐，视觉上就显得歪斜 - Python 的
"""块字符串同理：VSCode 只当它是普通字符串处理，不作文档注释语义解析
XML Tools 能否用于 /* */ 块注释格式化？
不能。XML Tools 专为 XML 设计，只处理 <tag> 和 <!-- -->，对 C/JS/Java 中的 /* */ 完全无感知。试图用它格式化含块注释的 .c 或 .js 文件，要么无反应，要么只格式化标签部分、忽略注释——甚至可能把 /* 当成 XML 注释开头而错误截断内容。
-
XML Tools的xmlTools.format.indentSize配置只影响 XML 元素缩进 - 它不解析
/* */内容，也不重排其内部换行或空格 - 混淆使用会导致格式错乱，尤其在
<script><!-- /* JS block */ --></script>这类混合场景下极易破坏结构
真正能做块注释“结构化处理”的只有语言服务，不是格式化器
块注释的语义解析（比如 JSDoc 提取参数、Go Doc 生成文档、JavaDoc 抽取 API）依赖语言服务器（Language Server），不是格式化扩展。VSCode 自带的 JavaScript/TypeScript 语言服务会在你输入 /** 后回车，自动生成 JSDoc 模板，但这是“补全”，不是“对齐”或“嵌套检测”。
-
/**+ Enter 触发的是typescript-language-server的 snippet 补全，非格式化行为 - 它不校验已有
/* */是否嵌套，也不修复缩进错位 - 第三方插件如
Document This也只是基于函数签名生成新注释，无法重排已有块注释 - 所谓“嵌套解析”，实际是编译器/静态分析器（如
gcc -Wcomment、eslint）的职责，VSCode 不参与
手动控制块注释可读性的唯一可靠方式
别指望一键对齐或自动嵌套修复。保持块注释清晰，靠的是约定和手动微调：
- 写
/* */时，始终让/*和*/单独成行，并与包裹代码同级缩进 - 避免跨多层缩进包裹，例如不要用
/*包住一个if块再包一层for—— 改用版本控制 revert 或#if 0 / #endif（C/C++）更安全 - 在 JS/TS 中，优先用
/** ... */（JSDoc）而非/* ... */，前者被语言服务识别，后者只是普通注释 - Python 里不用
/* */，三引号字符串"""必须顶格或严格对齐缩进，否则会被解释为运行时字符串而非注释
块注释不是格式化目标，而是语义标记。它的位置、嵌套、换行，最终由人来负责——工具只辅助生成和折叠，不替代判断。
