Ctrl+/ 和 Ctrl+Shift+A 是 VSCode 注释操作的核心命令，但它们的行为完全取决于光标位置、选区状态和 languageId —— 不是“按了就生效”，而是“按对了才起作用”。
Ctrl+/ 为什么只注释/取消当前行，而不是整个选区
VSCode 的 editor.action.commentLine 命令设计就是行级操作：它只检查光标所在的那一行是否已有行注释符（如 //、#），然后整行加或删。哪怕你用鼠标拖选了 10 行，只要光标停在第 3 行，就只动第 3 行。
- 想批量处理多行？必须用「行选择」：点击行号左侧空白，或按
Shift+Alt+↓（Windows/Linux）/Shift+Option+↓（macOS）逐行高亮 - 已框选文本？先按
Ctrl+Shift+L（Windows/Linux）/Cmd+Shift+L（macOS）把每行转成独立光标，再按Ctrl+/ - 光标落在行尾空白处时，
Ctrl+/可能插入//到行末（如a = 1;//），看起来像失效；移到行首字母上重试 - 右下角 languageId 显示
Plain Text或JSON时，Ctrl+/直接不响应 —— 点击它手动切为JavaScript或对应语言
Ctrl+Shift+A 插入的是 /* */ 还是 或 #？由什么决定
Ctrl+Shift+A 触发的是 editor.action.blockComment，它不硬编码符号，而是读取当前 languageId 的 commentRules 配置。Python 没原生块注释，VSCode 就 fallback 成连续 #；HTML 不支持 /* */，就套 <!-- -->；而 JSON 文件里按下去会静默失败。
- 该快捷键要求选区是「完整逻辑行」：不能含空行、纯注释行，也不能混用空格和 Tab 缩进
- 选中内容若跨函数/类边界（比如从
if (选到}中间有return），部分语言服务器可能误判层级，导致*/插入位置偏移 - 在 Remote-SSH 场景下，若远程端 language server 未启动，
Ctrl+Shift+A会退化为纯文本包裹，不校验语法合法性 - macOS 用户注意：
Cmd+Shift+/容易被系统 Spotlight 拦截，真正有效的块注释快捷键是Shift+Option+A
JSX/TSX 中 {/* */} 注释为什么 Ctrl+/ 不生效
不是文件后缀决定的，是 languageId。`.tsx` 文件默认可能是 typescript，但只有 typescriptreact 才启用 JSX 内部的 {/* */} 支持。
- 点击右下角语言标识（如显示
TypeScript），手动选TypeScript React - 永久生效：在工作区根目录
.vscode/settings.json中加"files.associations": {"*.tsx": "typescriptreact"} -
Ctrl+/在 JSX 元素内部（如<div>{<!-- cursor here -->}</div>）才插入{/* */}；在const a = 1;这类 TS 逻辑行仍用//，这是预期行为 - 想强制在 JSX 外部也用块注释？别依赖快捷键——直接输入
{/*，VSCode 会自动补全*/}
快捷键失效时，最该先查哪三件事
90% 的注释异常都卡在这三点上，比重装插件快得多：
- 右下角 languageId 是否正确？
Plain Text、JSON、Markdown这些都不支持标准注释逻辑 - 有没有插件劫持了快捷键？特别是 Vim、Emacs、Prettier、Auto Close Tag —— 在命令面板运行
Preferences: Open Keyboard Shortcuts (JSON)，搜editor.action.commentLine看是否被覆盖 - 是不是在折叠区域操作？VSCode 对折叠行不执行注释命令，展开后再试
languageId 错了，所有快捷键都是空转；插件冲突了，命令根本没走到编辑器核心；折叠状态下操作，连触发条件都不满足 —— 这三个点漏掉任何一个，后面调任何设置都没用。
