Keybindings 必须手动勾选才能同步，且依赖 Remote Development 扩展启用；若未生效，需检查同步项、扩展状态、冲突提示及平台适配。

Keybindings 必须手动勾选，否则不会同步

VSCode 的 Settings Sync 默认不自动勾选 Keybindings，哪怕你开了同步，新设备上 Ctrl+P、Ctrl+Shift+P 依然可能没反应——这不是插件问题，是同步项漏了。首次启用时弹出的 Choose what to sync 面板里，Keybindings 是独立选项，且默认未勾选。

• 务必在勾选列表中明确打勾 Keybindings，连同 Settings、Extensions、User Snippets、UI State 一起选上
• 如果已启用同步但快捷键没生效，不要重装 VSCode，直接运行 Preferences: Sync: Download Settings 再确认 Keybindings 是否在同步项中
• macOS 和 Windows 的 keybindings.json 文件内容结构一致，但部分快捷键（如 Cmd vs Ctrl）会自动适配系统，无需手动改键名

同步后快捷键不生效？检查 Remote Development 扩展是否启用

2026 年起，VSCode 的同步功能底层依赖 Remote Development 扩展提供的账户服务。如果这个扩展被禁用或未安装，Keybindings 就算勾了也上传不了，状态栏云图标会一直卡在 Signing in... 或直接不显示。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 打开扩展视图（Ctrl+Shift+X），搜索 Remote Development，确保它处于“已启用”状态
• 企业定制版 VSCode 常默认移除此扩展，需手动从 Marketplace 安装并重启编辑器
• 即使你从不用远程开发，也必须启用它——这是同步机制的硬性依赖，不是可选功能

自定义快捷键冲突或覆盖失败的常见原因

同步不是无脑覆盖。VSCode 遇到本地与云端快捷键定义冲突时，不会自动合并，而是跳过该条目，导致你明明上传了新绑定，另一台设备却没变。

• 冲突常发生在同一命令被不同扩展绑定（例如 editor.action.formatDocument 被 Prettier 和 ESLint 同时绑定），VSCode 只保留第一个加载的
• 运行 Sync: Show Conflicts 可查看具体冲突项，手动选择“Accept Incoming”或“Keep Local”
• 绑定到硬件专用键（如某些笔记本的 F12、Fn+Backspace）可能因平台差异失效，这类键建议只在单设备配置，不参与同步
• keybindings.json 中含绝对路径或环境变量的快捷键（如调用本地脚本）天然不同步，因为 sync.ignoredSettings 会过滤掉所有含路径字段的配置

手动备份 keybindings.json 作为兜底方案

当同步反复失败、或你只想迁移某几条快捷键（比如公司电脑和家用电脑用不同终端），直接复制 keybindings.json 是最可控的方式。

• 文件路径：Windows: %APPDATA%\Code\User\keybindings.json，macOS: ~/Library/Application Support/Code/User/keybindings.json，Linux: ~/.config/Code/User/keybindings.json
• 复制前关闭所有 VSCode 实例，避免文件被锁；粘贴后无需重启，VSCode 会自动重载
• 注意：手动覆盖会完全替换当前设备的快捷键配置，建议先备份原文件再操作
• 如果只是想加几条快捷键而非全量替换，用 Preferences: Open Keyboard Shortcuts (JSON) 直接编辑更安全

同步快捷键这事，表面是勾个选项，背后牵扯账户服务、扩展依赖、冲突策略和平台适配。最容易被忽略的是 Remote Development 扩展的状态，以及 Sync: Show Conflicts 这个命令——它不常被触发，但一旦快捷键没同步成功，八成就卡在这儿。