若“帮助:键盘快捷键参考”未响应,可依次尝试:一、用 Cmd+Shift+ P 调用命令;二、手动打开内置 keyboard-shortcuts.pdf;三、禁用扩展排查冲突;四、重置 keybindings.json 为 {};五、清除vscode 缓存。

如果您在 visual studio Code 中需要快速查看所有可用的键盘快捷键,但发现“帮助:键盘快捷键参考”命令未响应或无法正常打开 PDF 文档,则可能是由于默认 PDF 查看器配置异常、扩展冲突或用户设置覆盖所致。以下是解决此问题的多种方法:
本文运行环境:macBook air,macOS Sequoia。
一、使用内置命令面板重新触发快捷键参考
该方法绕过菜单栏点击路径,直接调用核心命令,可规避界面渲染或菜单绑定失效问题。
1、按下 Cmd + Shift + P(macos)或 Ctrl + Shift + P(windows/linux)打开命令面板。
2、在输入框中键入 Help: Keyboard Shortcuts Reference。
3、从下拉列表中选择该项并按回车键执行。
二、手动打开快捷键 PDF 文件路径
VSCode 内置的快捷键参考以 PDF 形式预编译在安装目录中,直接访问该文件可排除命令执行链路故障。
1、在 VSCode 中按下 Cmd + Shift + P 打开命令面板。
2、输入并选择 Developer: Open Extensions Folder,进入扩展根目录。
3、在 Finder(macOS)中依次向上导航至 Contents/Resources/app/out/vs/workbench/contrib/help/browser/ 路径。
4、查找名为 keyboard-shortcuts.pdf 的文件并双击用系统 PDF 阅读器打开。
三、重置键盘快捷键设置并禁用干扰扩展
第三方键位映射扩展(如 vim、emacs 模拟器)或自定义 keybindings.json 可能拦截或覆盖 Help 命令绑定,需临时隔离验证。
1、关闭所有 VSCode 窗口。
2、在终端中执行 code –disable-extensions 启动无扩展模式。
3、启动后立即按下 Cmd + Shift + P,输入并运行 Help: Keyboard Shortcuts Reference。
4、若此时可正常打开,说明某扩展导致冲突;逐一启用扩展并复测,定位问题扩展。
四、重建用户 keybindings.json 文件
损坏或语法错误的自定义快捷键配置会引发命令系统初始化失败,导致 Help 相关命令不可用。
1、按下 Cmd + Shift + P,输入并选择 Preferences: Open User Keybindings (json)。
2、全选内容并删除,仅保留一对空的大括号:{}。
3、保存文件(Cmd + S),重启 VSCode。
4、再次尝试执行 Help: Keyboard Shortcuts Reference。
五、清除 VSCode 缓存并重装快捷键资源
缓存文件损坏可能导致 help 资源加载失败,尤其在升级后出现兼容性问题时有效。
1、完全退出 VSCode(包括菜单栏图标)。
2、在 Finder 中前往 ~/Library/Caches/com.microsoft.VSCode.ShipIt/ 并清空其内容。
3、前往 ~/Library/application Support/Code/Cache/,删除全部子文件夹。
4、重新启动 VSCode,等待初始化完成后再执行快捷键参考命令。