Ctrl+/仅作用于光标所在行：智能判断增删行注释符，不响应选区；需确保languageId正确且光标不在行尾空白或折叠行，多行操作须整行选择或转多光标。
光标在任意位置时，Ctrl+/ 只作用于当前行
VSCode 的 Ctrl+/（Windows/Linux）或 Cmd+/（macOS）不是“注释选中内容”，而是「切换当前光标所在行的行注释状态」。哪怕你用鼠标拖选了 5 行，只要光标停在第 2 行，就只处理第 2 行。
常见错误现象：Ctrl+/ 按了没反应，或只动了一行却以为该批量生效。
- 光标落在行尾空白处（比如
a = 1;|），可能插入//到行末变成a = 1;//，看起来像错位；移到行首字母上重试 - 光标在折叠区域首行且该行被折叠时，VS Code 会跳过该行，不执行注释
- 若当前文件 languageId 是
Plain Text或JSON（非jsonc），快捷键直接静默失败
怎么确保 Ctrl+/ 一定能用
它不看文件名是否带后缀，只认 VS Code 内部的 languageId。右下角显示什么，就按什么来。
- 点击右下角语言标识（如显示
Plain Text），手动选成JavaScript、Python、HTML等真实语言 - 对
.env文件，需安装dotenv插件并设为Environment模式，否则#注释不生效 - 对自定义后缀（如
.cfg），在settings.json中加："files.associations": {"*.cfg": "ini"} - 禁用可能劫持快捷键的插件（如 Vim、Emacs 模拟器），或检查
keybindings.json是否覆盖了editor.action.commentLine
多行想一起注释？必须满足「整行选中」条件
Ctrl+/ 批量生效的前提是：选区必须包含完整行（含换行符），而不是“视觉上选中了几行文字”。
- 正确做法：按
Shift+Alt+↓（Windows/Linux）或Shift+Option+↓（macOS）逐行扩展选中整行 - 或点击行号左侧空白区域，再按
Shift+↓向下扩展 - 鼠标拖选后按
Ctrl+Shift+L（Windows/Linux）可把每行转为独立光标，再按Ctrl+/实现多光标行级注释 - 如果选中的是跨行文本但未到行尾（如从
function拖到{），Ctrl+/仍只处理光标所在行
不同语言下注释符号由谁决定
VS Code 不硬编码 // 或 #，而是读取当前 languageId 对应的 comments.lineComment 配置项。
-
.js和.ts→//；.py→#；.html→<!-- -->（单行适配） -
.json文件默认无lineComment，所以报错Unable to comment out line: No comment token defined for language 'json'；必须切到jsonc模式 -
.tsx默认 languageId 是typescript，不支持{/* */}；要 JSX 块注释，得手动切为typescriptreact - 自定义语言配置时漏写
comments字段，会导致Ctrl+/完全失效
实际操作中，最常被忽略的是 languageId 和整行选中的隐含前提——它不像 IDE 那样“智能猜测你要干啥”，而是严格按规则走。按一次没反应，先低头看右下角，再抬手调选区。
