Sync Keymapping

一个用于在各个类VSCode IDE之间同步快捷键配置的扩展。

功能特性

• 🔄 一键同步快捷键配置到多个IDE
• 🎯 支持 VS Code、Cursor、Windsurf、Trae
• 💾 自动备份原有配置（带时间戳的备份文件）
• 📜 保留完整的历史备份记录
• ⚙️ 可配置要同步的目标IDE
• 🖥️ 跨平台支持（macOS、Windows、Linux）
• 🔍 详细的同步结果输出

支持的IDE

• VS Code - Visual Studio Code
• Cursor - Cursor Editor
• Windsurf - Windsurf Editor
• Trae - Trae Editor

使用方法

1. 从当前IDE同步到其他IDE

在命令面板（Cmd+Shift+P 或 Ctrl+Shift+P）中执行：

Sync Keymapping: 从当前IDE同步快捷键

这会将当前IDE的快捷键配置同步到所有已启用的其他IDE。

2. 选择源IDE并同步

Sync Keymapping: 选择源IDE并同步

这会显示一个选择列表，让你选择要作为源的IDE，然后同步到其他IDE。

3. 同步到所有IDE

Sync Keymapping: 同步快捷键到所有IDE

从当前IDE同步快捷键配置到所有其他IDE。

配置选项

启用/禁用IDE同步

在设置中可以配置要同步的目标IDE：

{
  "sync-keymapping.enabledIDEs": {
    "vscode": true,
    "cursor": true,
    "windsurf": true,
    "trae": false
  }
}

将不想同步的IDE设置为 false 即可跳过。

自定义IDE路径

如果你的IDE安装在非默认位置，或使用了便携版，可以配置自定义路径：

{
  "sync-keymapping.customPaths": {
    "vscode": "",
    "cursor": "/custom/path/to/Cursor/User/keybindings.json",
    "windsurf": "",
    "trae": ""
  }
}

说明：

• 留空（""）则使用默认路径
• 填写完整的绝对路径指向 keybindings.json 文件
• 支持 ~ 表示用户主目录（macOS/Linux）
• Windows 路径示例：C:\\Users\\YourName\\CustomPath\\Code\\User\\keybindings.json

快捷键配置文件位置

macOS

• VS Code: ~/Library/Application Support/Code/User/keybindings.json
• Cursor: ~/Library/Application Support/Cursor/User/keybindings.json
• Windsurf: ~/Library/Application Support/Windsurf/User/keybindings.json
• Trae: ~/Library/Application Support/Trae/User/keybindings.json

Windows

• VS Code: %APPDATA%\Code\User\keybindings.json
• Cursor: %APPDATA%\Cursor\User\keybindings.json
• Windsurf: %APPDATA%\Windsurf\User\keybindings.json
• Trae: %APPDATA%\Trae\User\keybindings.json

Linux

• VS Code: ~/.config/Code/User/keybindings.json
• Cursor: ~/.config/Cursor/User/keybindings.json
• Windsurf: ~/.config/Windsurf/User/keybindings.json
• Trae: ~/.config/Trae/User/keybindings.json

安全性

自动备份机制

每次同步前，扩展会自动备份目标IDE的原有配置：

• 备份文件格式：keybindings.json.backup.YYYY-MM-DDTHH-MM-SS
• 示例：keybindings.json.backup.2026-02-09T11-18-23
• 保留策略：每次同步创建新备份，不会覆盖旧备份
• 恢复方法：手动将备份文件重命名为 keybindings.json 即可恢复

备份文件位置

备份文件与原配置文件在同一目录下：

• macOS: ~/Library/Application Support/{IDE}/User/
• Windows: %APPDATA%\{IDE}\User\
• Linux: ~/.config/{IDE}/User/

清理建议

随着时间推移，备份文件会逐渐积累。建议定期清理旧的备份文件以节省空间。

开发

安装依赖

npm install

编译

npm run compile

监听模式

npm run watch

调试

按 F5 在扩展开发主机中启动扩展。

打包

npm install -g @vscode/vsce
vsce package

许可证

MIT

贡献

欢迎提交 Issue 和 Pull Request！