Ctrl+/仅切换光标所在行注释状态，非选区操作；多行需整行选择或转多光标后使用；块注释Shift+Alt+A依赖语言支持；跨语言稳定方案为Ctrl+K C/U。

Ctrl+/ 只对光标所在行生效，不是“选中几行就注释几行”

这是最常被误解的一点：哪怕你用鼠标拖选了 5 行代码，只要光标停在第 2 行，Ctrl+/（Windows/Linux）或 Cmd+/（macOS）只会切换第 2 行的注释状态。它本质是「切换当前光标行」，不是「作用于选区」。

要真正批量处理多行：

• 用 Shift+Alt+↓（Windows/Linux）或 Shift+Option+↓（macOS）逐行扩展选择（点击行号左侧空白也等效）
• 或者先按 Ctrl+Shift+L（Windows/Linux）/Cmd+Shift+L（macOS）把选中文本转为多光标，再按 Ctrl+/
• 确认右下角状态栏显示的是正确 languageId（如 python、javascript），不是 Plain Text

块注释 Shift+Alt+A 在不同语言里行为差异很大

Shift+Alt+A（Windows/Linux）或 Shift+Option+A（macOS）看起来是“包裹选区”，但实际是否生效、怎么包裹，完全取决于语言支持：

• JavaScript/TypeScript/C++：插入 /* */ 包裹整个选区，缩进保留较好
• Python：多数情况下静默失败；部分版本 fallback 成连续三引号 ''' '''，但不保证格式对齐
• HTML：可能退化为每行加 ，若末尾无换行，容易吞掉下一行首字符
• JSON/.env 等不支持注释的格式：直接无反应，不是 bug

真正跨语言稳定的块级屏蔽操作，建议改用 Ctrl+K Ctrl+C（行注释批量加） + 手动补 /* 和 */，反而更可控。

快捷键失效时，90% 是 languageId 没识别对

VSCode 不看文件后缀，只认 languageId。比如打开 script.tsx，如果右下角显示的是 typescript 而非 typescriptreact，那么 JSX 内部的 {/* */} 就不会被 Ctrl+/ 插入。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

排查和修复步骤：

• 按 Ctrl+Shift+P → 输入 Developer: Inspect Editor Tokens and Scopes → 看光标处 languageId 是什么
• 点击右下角语言标识，手动选对（如 Shell Script、TypeScript React）
• 永久修复：在工作区 .vscode/settings.json 中加配置：

  "files.associations": {
    "*.sh": "shellscript",
    "*.tsx": "typescriptreact"
  }

远程开发或插件冲突时，用 Ctrl+K C / Ctrl+K U 更可靠

当 Ctrl+/ 在 WSL 或 SSH 连接中失灵，或被 Vim、Prettier 等插件劫持时，Ctrl+K Ctrl+C（Windows/Linux）和 Cmd+K Cmd+C（macOS）是底层更稳定的替代方案。

它们的特点：

• 不依赖 languageId，对任意选中文本都强制加行注释符（//、#、-- 等）
• 不尝试智能包裹，纯文本前缀操作，不会因缩进/空行错位
• 对应取消注释是 Ctrl+K Ctrl+U（Windows/Linux）或 Cmd+K Cmd+U（macOS）
• 在只读文件或权限受限场景下也比 Ctrl+/ 更易触发

languageId 错误、插件干扰、远程透传失败——这三类问题加起来占注释失效案例的绝大多数，而 Ctrl+K Ctrl+C 几乎不踩这些坑。