Ctrl+/ 和 Ctrl+Shift+A 是两个独立命令，前者行级注释不依赖选区，后者块注释依赖 languageId 和选区完整性；正确使用需先确认右下角 languageId。
Ctr+Shift+A 和 Ctrl+/ 不是“切换”关系，而是两个独立命令——一个管包裹，一个管行级开关；强行当成切换用，反而容易注释错行、漏行或破坏语法。
Ctrl+/ 为什么不是块注释的“反向操作”
它绑定的是 editor.action.commentLine，只看光标在哪一行，不关心你选了多少行。哪怕你拖选了 5 行，光标停在第 3 行，就只动第 3 行。这不是 bug，是设计如此。
- 常见错误现象：
Ctrl+/后只有第一行被注释，其余无反应 - 真正多行生效的前提：用
Shift+Alt+↓（Windows/Linux）或Shift+Option+↓（macOS）做整行选择，再按Ctrl+/ - 光标落在行尾空白处时，
Ctrl+/可能插入//到行末（如a = 1;//），看起来像失效；移到行首字母上重试 - 右下角 languageId 显示
Plain Text或JSON时，Ctrl+/直接不响应——必须手动切为对应语言
Shift+Alt+A 的包裹逻辑依赖 languageId 和选区完整性
Shift+Alt+A 触发 editor.action.blockComment，它的行为完全由当前 languageId 的 commentRules 决定，不是简单套 /* */。
- Python 文件里按
Shift+Alt+A基本没反应——因为 Python 没原生块注释，VSCode 不 fallback 成#，而是静默跳过 - JSX/TSX 中，若右下角显示
TypeScript而非TypeScript React，{/* */}注释不会生效 - 选区含空行、纯注释行、或缩进混用 Tab/空格时，
Shift+Alt+A会跳过“不合规”的行，导致部分未被包裹 - CSS/SCSS 中最稳定，因为语法天然支持
/* */，且不依赖语言服务器
团队规范落地：别靠快捷键记忆，靠统一配置和强制行为
靠开发者记“什么时候该用哪个快捷键”，在多人协作中极易出错。实际落地更有效的方式是收口控制点：
- 在工作区根目录
.vscode/settings.json中统一配"files.associations"，比如：{"*.tsx": "typescriptreact"}，避免 JSX 注释失效 - 禁用易混淆的快捷键：在
keybindings.json中把editor.action.blockComment绑定为空操作，强制所有人用Ctrl+K Ctrl+C/U做多行行注释 -
Ctrl+K Ctrl+C和Ctrl+K Ctrl+U不依赖 languageId，对缩进、空行、混合空格都鲁棒，适合 CI/CD 环境下的代码审查屏蔽 - 对 Python 团队，直接禁用
Shift+Alt+A，文档明确要求用三引号"""或连续#手动写块注释，避免 VSCode fallback 行为引发歧义
真正容易被忽略的不是快捷键本身，而是 languageId 的隐式状态——它不显眼，却决定所有注释行为是否生效。每次打开陌生文件，先看右下角，比背快捷键重要十倍。
