VSCode注释快捷键失效需按五步排查：一、验证并重置默认快捷键；二、检查语言模式是否启用注释支持；三、禁用冲突扩展插件；四、通过命令面板手动触发注释命令；五、重置用户键盘映射为出厂默认。
如果您在使用 VSCode 编辑代码时，发现快捷键无法正确执行注释操作，可能是由于键盘映射冲突、语言模式不匹配或快捷键被自定义覆盖所致。以下是针对“切换行注释”与“切换块注释”功能异常的多种排查与修复方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、验证并重置默认快捷键绑定
VSCode 的注释功能依赖于准确的键盘快捷键绑定，若用户曾修改或扩展插件覆盖了原始快捷键，则会导致功能失效。需确认当前绑定是否符合官方默认设定，并在必要时还原。
1、按下 Cmd + K 后立即松开，再按 Cmd + C，测试“切换行注释”是否生效。
2、按下 Cmd + K 后立即松开，再按 Cmd + U，测试“切换块注释”是否生效。
3、打开命令面板（Cmd + Shift + P），输入 Preferences: Open Keyboard Shortcuts (JSON)，检查是否存在对 editor.action.commentLine 或 editor.action.blockComment 的自定义覆盖项。
4、若存在干扰条目，在 JSON 文件中将其删除或注释掉，保存后重启 VSCode。
二、检查当前语言模式是否启用注释支持
VSCode 的注释命令仅在识别出有效语言模式（Language Mode）时才激活。若编辑器右下角显示为“Plain Text”或未识别语言，则注释快捷键将无响应。
1、查看窗口右下角状态栏，确认当前语言标识（如 JavaScript、Python 等）是否已正确设置。
2、若显示为 Plain Text，点击该区域，在弹出菜单中选择对应语言，例如 TypeScript。
3、若列表中无目标语言，通过命令面板运行 Change Language Mode，手动指定。
4、保存文件为带扩展名的格式（如 .ts、.py），确保 VSCode 自动识别语言模式。
三、禁用可能冲突的扩展插件
部分第三方扩展（如 Vim 模式、Emacs 键盘映射、代码格式化工具）会劫持或重绑定注释相关命令，导致原生快捷键失效。
1、打开扩展视图（Cmd + Shift + X），在搜索框中输入 vim、emacs、beautify 等关键词。
2、逐一禁用疑似插件，每次禁用后重启 VSCode 并测试注释功能是否恢复。
3、若某插件禁用后功能恢复正常，进入该插件设置页，查找与 commentLine 或 blockComment 相关的配置项，将其设为 false 或清除对应快捷键绑定。
四、手动触发命令替代快捷键
当快捷键持续无效时，可通过命令面板直接调用注释命令，绕过键盘映射问题，同时验证底层功能是否完好。
1、选中需要注释的一行或多行代码。
2、按下 Cmd + Shift + P 打开命令面板。
3、输入 Toggle Line Comment，回车执行。
4、再次打开命令面板，输入 Toggle Block Comment，回车执行。
5、若命令面板方式可正常执行，说明核心功能可用，问题明确指向快捷键配置层。
五、重置用户键盘映射为出厂默认
若前述步骤均未解决，可能存在深层的 keyboard shortcuts.json 损坏或残留错误绑定，此时需彻底清空用户级快捷键配置。
1、关闭 VSCode。
2、在 Finder 中前往 ~/Library/Application Support/Code/User/ 路径。
3、定位并重命名文件 keybindings.json 为 keybindings.json.bak。
4、重新启动 VSCode，系统将自动创建新的默认 keybindings.json 文件。
5、再次测试 Cmd + K Cmd + C 与 Cmd + K Cmd + U 是否恢复正常响应。
