Shift + Alt + A 不总是包裹代码是因为 VSCode 严格依据语言模式和选区结构决定行为：遇空行、缩进不一致或语言不支持时，会降级为行注释或跳过，属安全策略非 bug。
Shift + Alt + A 为什么有时不包裹、只加空行？
VSCode 的 Shift + Alt + A 不是“无脑包裹”，它严格依赖当前语言模式和选区结构。如果选中区域包含空行、缩进混杂（比如部分行用空格、部分用 Tab）、或首尾行缩进不一致，VSCode 会拒绝插入 /* */，转而只在每行开头加 //（若语言支持）或干脆跳过——这不是 bug，是安全策略。
实操建议：
- 选中前先用
Ctrl + [或Ctrl + ]统一缩进，确保所有行左边界对齐 - 删掉选区内的空行，或手动把光标移到非空行再拖选
- 检查右下角语言标识：JSX 文件必须设为
typescriptreact，否则Shift + Alt + A对 JSX 元素内代码无效 - Python 文件里选中多行后按该快捷键，会用
"""包裹，而非/* */——这是正确行为，不是配置错误
如何让块注释自动对齐到指定列（比如第 40 列）？
VSCode 原生不提供“注释对齐到 X 列”的快捷键，但可通过组合操作逼近效果。核心逻辑是：先用多光标编辑定位注释起始位置，再统一补空格。
实操建议：
- 用
Alt + 鼠标左键在每行注释前点击，生成多个光标 - 按
→键逐个移动光标到目标列（如第 40 列），或输入固定空格数（如按 35 次Space） - 输入
/*，VSCode 会自动补全*/，且每行起始位置一致 - 若已有注释内容，可先选中所有
/*到*/，用Ctrl + Shift + P运行editor.action.formatSelection触发格式化（需语言扩展支持）
嵌套块注释失败？别硬套，换思路
C、C++、Java、JavaScript 等语言的 /* */ 不支持嵌套，VSCode 也**不会帮你检测或修复**。比如写成 /* outer /* inner */ outer */，编译器会报错或截断，VSCode 只负责插入/删除符号，不校验语义。
实操建议：
- 调试时想临时屏蔽含块注释的代码段，改用
Ctrl + /逐行加//，避开嵌套问题 - Python 用三重引号模拟块注释时，
"""内部允许出现'''，但反过来不行——注意引号类型匹配 - Go 语言只认
/* */，且明确禁止嵌套；强行嵌套会导致构建失败，VSCode 不会高亮警告 - 真正需要嵌套说明，用 JSDoc 风格（
/** ... */）+ 工具链（如 TypeDoc）生成文档，而非运行时注释
快捷键冲突或失效？优先查这三项
Shift + Alt + A 和 Ctrl + / 失效，90% 是环境配置问题，不是插件故障。
实操建议：
- 打开命令面板
Ctrl + Shift + P，输入Preferences: Open Keyboard Shortcuts (JSON)，确认editor.action.blockComment绑定未被覆盖 - 右下角点击语言模式，确认不是
Plain Text——哪怕文件是.js，也可能因历史操作被误设 - 禁用所有插件后重试：某些格式化扩展（如 Prettier）会在保存时自动删注释，造成“刚加完就消失”的错觉
真正麻烦的是跨语言混合文件（比如 Vue 单文件组件里的 <script> + <template>），VSCode 会按当前光标所在区块的语言决定注释语法——这点没法全局统一，只能分段操作。
