keybindings.json是唯一可信的快捷键源文件，图形界面仅为视图层，不保存默认项且不校验语法；所有生效绑定必须显式写入该文件，且需确保key、command、when三字段完整匹配，大小写、空格、修饰键顺序及when条件均敏感。
keybindings.json 是唯一可信的快捷键源文件
VSCode 的快捷键配置只在 keybindings.json 中真实生效，图形界面（Ctrl+K Ctrl+S）只是视图层，它不保存未修改的默认项，也不校验 JSON 语法。你看到的“已启用/禁用”状态，不代表它们存在于文件里——只有显式写入 keybindings.json 的条目才参与匹配和执行。
常见错误现象：在设置界面改了快捷键，重启后失效；或复制界面里显示的 JSON 片段到文件中，结果整个快捷键系统变迟钝甚至部分命令无法触发。原因就是混入了中文引号、全角空格，或漏掉了 when 字段导致上下文不匹配。
- 必须通过命令面板运行
Preferences: Open Keyboard Shortcuts (JSON)打开文件，这是唯一保证结构合法、路径正确、上下文为用户级的方式 - 首次打开时文件可能为空，别慌——添加自定义项后 VSCode 会自动补全数组括号
[] - 不要从设置 UI 复制粘贴内容，那不是源，是渲染结果
跨平台迁移时 key 字段要手动适配
Windows 上的 "key": "ctrl+shift+k" 在 macOS 上不会触发，因为 VSCode 默认把 ctrl 映射为 cmd，但这个映射不是自动转换的——它只对内置默认快捷键生效，对 keybindings.json 里的自定义项完全不处理。
如果你在 Windows 备份了配置，直接挪到 Mac 上，ctrl+alt+t 这类组合键会彻底失灵，且 VSCode 不报任何错误，只会静默忽略。
- macOS 用户应统一把
ctrl改成cmd，alt改成ctrl（例如"key": "cmd+shift+k"） - Linux 和 Windows 之间相对友好，但注意某些键位（如
Super）在不同桌面环境行为不一致 - 避免使用
ctrl+alt这类易被系统级快捷键劫持的组合，尤其在 macOS 上容易和 Spotlight 冲突
恢复时别跳过重启和验证步骤
覆盖 keybindings.json 后不重启 VSCode，旧缓存仍生效；即使重启了，也不代表所有快捷键都可用——有些命令依赖扩展就绪，而扩展加载有延迟。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
典型问题：你导入了 "command": "python.execInTerminal"，但按快捷键没反应。其实不是快捷键错了，而是 ms-python.python 扩展还没完成初始化，或者根本没装上。
- 先确认扩展已安装并启用：
code --list-extensions | grep python - 重启 VSCode 后，打开命令面板（Ctrl+Shift+P），输入对应命令名（如
Python: Run Python File in Terminal），看是否能手动触发 - 再测试快捷键；如果命令存在但快捷键无效，用 Ctrl+K Ctrl+S 打开快捷键编辑器，搜索该命令，看右侧是否显示你设的键位，以及是否有黄色警告图标（表示
when条件不满足）
团队共享配置要小心 when 条件和命令可用性
直接把个人 keybindings.json 推到 Git 仓库给团队用，很容易出问题。比如你写了 "when": "editorTextFocus && editorLangId == 'typescript'，但队友没装 TypeScript 相关扩展，VSCode 就识别不出 editorLangId，整条规则失效。
更隐蔽的是命令 ID 变更：VSCode 1.85 把 workbench.action.terminal.toggle 拆成了 workbench.action.terminal.toggleTerminal，旧配置在新版本里变成无效字符串，但不报错。
- 团队共用配置建议只保留通用命令，如
editor.action.formatDocument、workbench.action.files.save - 避免强依赖特定扩展的命令，除非已在
extensions.txt中锁定版本 - 用
when时优先选宽泛条件，如editorTextFocus，少用resourceExtname == '.py'这类易失效的判断
真正难的不是导出或覆盖文件，而是理解 VSCode 快捷键系统本质是个“条件匹配器”：它不关心你按了什么，只关心当前上下文是否满足 when、目标命令是否存在、扩展是否已激活。这三个环节任一断裂，快捷键就静默失效——而日志里什么都不会说。
