VSCode如何离线迁移所有的插件和个人快捷键配置到另一台新电脑

VSCode如何离线迁移所有的插件和个人快捷键配置到另一台新电脑

答案是肯定的，但得拆成两步走：插件迁移靠code --list-extensions配合.vsix文件批量安装，而快捷键配置则要手动复制keybindings.json文件。这两套机制完全不同，混为一谈肯定会失败。

导出插件列表时为什么不能截图或复制显示名

这里有个常见的“坑”：你在VSCode扩展市场里看到的“Python”、“Prettier”只是显示名，并非真实的安装标识。真正的插件ID是像ms-python.python、esbenp.prettier-vscode这样的字符串。如果你直接用显示名执行code --install-extension Python，结果只会是报错：Extension 'Python' not found in the marketplace。

正确的操作流程应该是：

• 在旧电脑的终端里运行code --list-extensions --show-versions > extensions.txt，生成一份带版本号的插件ID列表。
• Windows用户如果使用CMD，请先确认code命令已加入系统PATH；更稳妥的做法是使用PowerShell，同时注意重定向符号别写成>>，以免造成文件内容追加混乱。
• 务必把生成的文本文件保存为UTF-8编码，否则如果列表里包含中文名的插件（比如一些国产定制插件），迁移到新环境时可能会出现乱码问题。

离线安装插件时卡住或静默失败的真正原因

当你执行code --install-extension时，它的默认行为是联网校验插件签名并检查更新。一旦网络不通，进程就可能卡在等待状态。更棘手的是，如果目标机器的原生二进制模块不匹配，安装过程甚至会静默失败——日志可能显示Installation completed，但插件实际上并未生效。

要避免这些问题，有几个关键点需要注意：

• 安装时必须加上--force参数，强制跳过“插件已存在”的提示，防止重复安装引发冲突。
• 在Linux或macOS环境下，建议用timeout 120命令为每个插件安装设置最长等待时间，防止进程死锁。命令可以这样写：while read ext; do timeout 120 code --install-extension "$ext" --force; done
• Windows PowerShell用户可以这样操作：Get-Content extensions.txt | ForEach-Object { code --install-extension $_ --force }。不过在此之前，最好先在VSCode设置里关闭extensions.autoCheckUpdates选项。
• 还有一个技术细节：那些包含原生代码的插件（例如ms-vscode.cpptools或esbenp.prettier-vscode），要求目标机器上的Node.js版本与VSCode内置的版本相匹配，否则插件将无法正常加载。

快捷键配置不能靠Settings Sync或插件列表同步

Settings Sync功能（基于GitHub Gist的方案）依赖网络，而且在离线场景下，部分自定义键位可能无法被完整同步。至于插件列表导出命令code --list-extensions，它根本不涉及快捷键配置。

那么，快捷键配置的唯一可靠来源是什么？就是keybindings.json这个文件。它的存放路径如下：

• Windows系统：%APPDATA%\Code\User\keybindings.json
• macOS系统：~/Library/Application Support/Code/User/keybindings.json
• Linux系统：~/.config/Code/User/keybindings.json

迁移时，直接把这个文件复制到新电脑的对应路径下即可生效，甚至不需要重启VSCode（支持热重载）。

如果原来的配置里包含了平台敏感的按键（比如ctrl和cmd的区别），建议使用when条件表达式来做平台适配。例如："when": "editorTextFocus && !isMac"。

最后，还有一个最容易被忽略的关键点：插件ID列表和keybindings.json文件必须分开处理。而且，导出插件列表时一定要使用--show-versions参数来确保版本一致性。一份没有版本号的code --list-extensions输出，在VSCode 1.85和1.90这两个版本上，可能会安装出行为完全不同的插件，这无疑会给迁移工作埋下隐患。