最常见原因是 Settings Sync 未勾选“Keybindings”，即使开启同步也默认关闭；需手动配置并触发上传，且跨平台需用 when 条件区分 cmd/ctrl，避免冲突和静默失效。
为什么快捷键同步后在新设备上不生效
最常见原因是 keybindings.json 没被真正上传或下载——VSCode 官方 Settings Sync 默认不勾选“Keybindings”，即使你开了同步，它也处于关闭状态。右下角云图标只表示同步功能启用，不代表快捷键已同步。
检查方法：打开命令面板（Ctrl+Shift+P），运行 Sync: Show Summary，展开 Keybindings 条目，看“Last Sync”时间是否更新；若显示“Not synced”，说明该项从未被选中上传。
- 必须手动进入
Settings Sync配置页（命令面板输入Preferences: Configure Settings Sync），勾选Keybindings - 上传动作不会自动触发：改完快捷键后，得主动运行
Sync: Trigger Sync或点击状态栏云图标 → “Upload” - macOS 和 Windows 的修饰键映射不同（
cmdvsctrl），同一份keybindings.json直接同步过去可能部分失效，需用when条件区分平台
如何让 Ctrl+Shift+K 在所有设备上都删除行，而不是触发 GitLens
冲突不是“删掉对方”，而是靠 when 表达式让自己的绑定优先匹配。GitLens 的 ctrl+shift+k 通常带 gitlens:enabled && editorTextFocus 条件，而你的自定义只要条件更宽或更准，就能抢占执行权。
- 在
keybindings.json末尾添加新条目，不要删默认项：[{ "key": "ctrl+shift+k", "command": "editor.action.deleteLines", "when": "editorTextFocus && !editorReadonly" }] -
!editorReadonly是关键：GitLens 绑定往往没这个限制，而 VSCode 匹配时会优先选中条件更具体的那条 - 避免用
ctrl+shift+p这类系统级敏感组合去绑定非命令面板功能，Windows 下易被杀毒软件拦截，Linux 下可能和桌面环境冲突
跨平台快捷键同步时，Cmd 和 Ctrl 键怎么统一
不能强行统一物理按键，但可以用 when + 多条绑定实现逻辑一致。VSCode 支持按平台写不同 key，共用同一个 command。
- 在
keybindings.json中写两条，VSCode 会自动按当前 OS 选择生效项：[{ "key": "cmd+shift+f", "command": "editor.action.formatDocument", "when": "editorTextFocus && isMac" }, { "key": "ctrl+shift+f", "command": "editor.action.formatDocument", "when": "editorTextFocus && !isMac" }] -
isMac是内置上下文变量，无需额外安装插件；!isMac覆盖 Windows/Linux，比单独写isWindows更稳妥 - 别依赖
alt键做跨平台主键：macOS 的alt等价于 Windows 的alt，但常被输入法或系统快捷键劫持，实测稳定性差
同步后快捷键突然失效，但配置文件里明明有记录
大概率是 when 条件写错，或扩展未就绪导致命令不可用。VSCode 不报错，只是静默跳过绑定。
- 运行
Developer: Toggle Developer Tools，切换到 Console 标签，按失效快捷键，看是否有command 'xxx' not found报错——说明对应扩展没装或没激活 - 检查命令名拼写：
editor.action.formatDocument≠editor.action.formatSelection，少个Document就不生效 - 某些命令（如
python.sortImports）依赖插件启动完成，刚同步完插件列表，但插件本身还在 Installing… 状态，此时快捷键无效；需手动点扩展面板右上角刷新按钮 - 工作区级
.vscode/keybindings.json永远不参与同步，如果误把自定义写在这里，换设备后必然丢失
Sync: Trigger Sync 是否执行，以及目标设备是否已完成 Download。最容易被忽略的，是那些没报错、没提示、只是“按了没反应”的静默失效——它不来自配置错误，而来自命令未就绪或条件未满足。 
