settings sync 必须显式勾选keybindings才能同步快捷键，否则即使开启同步也不会传输；登录github或microsoft账号后需手动确认settings、keybindings、extensions、snippets、ui state五项全勾选，右下角显示sync: on才算生效。
Settings Sync 必须显式勾选 Keybindings 才能同步
很多人开了 Settings Sync 却发现快捷键没过去，根本原因是 Keybindings 项默认不自动启用。哪怕你点了“同步全部”，UI 上也可能漏掉这一项——它和 Settings、Extensions 是并列的五个独立开关，缺一不可。
操作时务必用 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入 Settings Sync: Turn On，登录 GitHub 或 Microsoft 账号后，手动确认以下五项全被勾选：Settings、Keybindings、Extensions、Snippets、UI State。右下角状态栏显示 Sync: On (GitHub) 或 Sync: On (Microsoft) 才算真正生效；灰色云朵图标只是待机状态，不代表已同步。
Windows 和 macOS 的快捷键不会“自动改写”，但会平台适配
你在 Windows 上写的 {"key":"ctrl+k ctrl+s"}，同步到 macOS 后内容不变，VSCode 运行时会把 ctrl 自动解释为 Cmd 键——这是它的平台感知逻辑，不是 bug，也不需要你手动替换字符串。
但要注意这些例外：
- 非标准组合如
ctrl+alt+[在 macOS 上可能无对应物理键，或被系统级快捷键（比如 Mission Control）劫持 -
alt在 macOS 上映射为option，但部分插件命令依赖alt的原始行为，导致功能异常 - 如果你在 macOS 上自定义了
cmd+shift+p，而 Windows 端也用了ctrl+shift+p，两者本质是同一逻辑，无需额外处理
手动导出/导入 keybindings.json 是最可靠的兜底方式
当 Settings Sync 失败（比如网络中断、账号冲突、权限拒绝），直接操作配置文件反而更快更可控。关键不是内容，而是路径不能错：
Windows：%APPDATA%\Code\User\keybindings.json
macOS：~/Library/Application Support/Code/User/keybindings.json
Linux：~/.config/Code/User/keybindings.json
操作步骤很简单：
- 在源设备上执行
Preferences: Open Keyboard Shortcuts (JSON)，全选复制内容 - 在目标设备上找到对应路径的
keybindings.json，粘贴覆盖，保存 - 必须重启 VSCode——不重启，新配置不会加载
团队共享 keybindings.json 时要注意 when 条件的兼容性
多人共用一份 keybindings.json 文件时，when 字段容易成为隐形坑点。比如 "when":"editorHasRenameProvider && editorTextFocus" 在某些语言插件未安装的机器上会失效，导致快捷键“看起来存在却按不动”。
推荐做法：
- 优先使用宽泛条件，如
editorTextFocus或textInputFocus，避免强依赖特定插件能力 - 对语言专属快捷键（如 Python 的
python.execInTerminal），单独加注释说明适用前提 - 不要在团队配置里绑定已被系统占用的组合，例如 macOS 的
cmd+space（Spotlight）、Windows 的ctrl+shift+esc（任务管理器）
跨平台协作真正的复杂点不在同步机制本身，而在不同系统底层快捷键拦截层级的差异——VSCode 只管命令映射，不管系统是否放行。一旦某个组合被 OS 或其他应用截获，VSCode 就收不到事件，再完美的 JSON 配置也无效。
