最直接方法是打开命令面板(Ctrl+Shift+P/Cmd+Shift+P),输入“Preferences: Open Keyboard Shortcuts”进入快捷键设置页;搜索toggle line comment、toggle block comment或editor.action.commentLine即可定位注释命令。

怎么快速查到当前生效的注释快捷键?
打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P),输入 Preferences: Open Keyboard Shortcuts,回车即可进入快捷键设置页。这是最直接、最可靠的入口,不依赖记忆或文档。
在搜索框里输入以下任一关键词,都能立刻定位核心注释命令:
-
toggle line comment—— 对应单行注释开关(Ctrl+/默认绑定) -
toggle block comment—— 对应块注释开关(Shift+Alt+A默认绑定) -
editor.action.commentLine—— 底层命令名,冲突时必搜
注意:VSCode 不会显示“未绑定”的命令,只列出已配置项;若搜不到,说明该命令被插件完全屏蔽或尚未启用。
为什么搜到了却没显示快捷键?
常见原因是该命令被插件覆盖、禁用,或绑定在非默认上下文(when 条件限制)。例如,你看到 editor.action.commentLine 有两条记录,一条来自 Default,另一条标着 Extension(比如 Vim 或 IntelliJ Keymap),后者优先级更高,就会压掉默认行为。
此时可:
- 悬停在冲突项上,点右侧垃圾桶图标「禁用此快捷键」(推荐,比删除更安全)
- 右键 →「在 settings.json 中编辑」,手动加一条带
when条件的覆盖规则(如仅在editorTextFocus && !editorReadonly时生效) - 避免直接改
keybindings.json—— 少一个逗号就导致全部快捷键静默失效
语言模式错乱时,注释快捷键会“消失”
不是快捷键没了,而是 VSCode 根本没触发它。右下角状态栏显示 Plain Text 或空白?那 Ctrl+/ 就只会插入普通字符,不会加 // 或 #。
验证方式:
- 点击右下角语言标签,手动选
javascript、python等真实语言 - 按
Ctrl+K Ctrl+M快速呼出语言选择器 - 进命令面板搜
Developer: Inspect Editor Tokens and Scopes,看当前languageId是什么(比如typescriptreact才支持 JSX 内 {/* */} 注释)
如果文件后缀识别不准(如 .sh 被当作文本),可在工作区 .vscode/settings.json 加 "files.associations": {"*.sh": "shellscript"}。
多行注释只动了一行?那是光标没选对
Ctrl+/ 默认只操作「光标所在行」,不是「鼠标拖选区域」。你拖选了 5 行,但光标停在第 1 行,结果只有第 1 行被注释。
正确做法:
- 用行选择:点击行号左侧空白处(整行高亮),或按
Shift+Alt+↓扩展选中多行 - 转多光标:先
Ctrl+Shift+L(Windows/Linux)把选区转为多光标,再按Ctrl+/ - 块注释(
Shift+Alt+A)则依赖文本选中(鼠标拖选),不是行选中;但要注意末尾无换行时可能吞掉下一行首字符
真正容易被忽略的点是:快捷键是否生效,80% 取决于「焦点是否在编辑器内」「文件是否只读」「语言模式是否匹配」——这三者任何一个不满足,editor.action.commentLine 就不会执行,连报错都不会有。











