VSCode配置Node.js开发环境的备份与恢复

直接备份 VSCode 的 Node.js 开发环境，这事儿吧，光把 settings.json 导出存起来，还真不够。真正的目标应该是还原“VSCode 能正确识别、运行、调试 Node.js 代码”的完整能力链。如果只恢复插件和外观设置，大概率会翻车——终端报个 command not found，调试器提示 Cannot find runtime 'node'，或者 TypeScript 的智能跳转直接失灵，都是家常便饭。

为什么光备份 settings.json 不管用

VSCode 对 Node.js 的支持，靠的是三层独立的机制，缺一层都不行：

• 首先是 PATH 环境变量：终端里能不能敲 node、npm，取决于 VSCode 启动时从系统继承过来的 PATH，跟你写在 settings.json 里的路径完全是两码事。
• 其次是 launch.json 调试配置：调试器能不能找到 Node.js 运行时，是由项目里 .vscode/launch.json 文件中的 runtimeExecutable 字段，或者全局查找逻辑决定的。
• 最后是 jsconfig.json / tsconfig.json：智能提示、跳转、类型检查能否正常工作，靠的是项目根目录下的这些配置文件，而不是用户设置里的任何东西。

所以，只备份 settings.json，相当于只保存了“外貌偏好”，却没保存“运行能力”。重装之后，就算主题和字体都回来了，按 F5 调试依然会失败。

必须备份的三个关键位置（跨平台通用）

按照实际影响排序，漏掉下面任何一项，Node.js 功能都会降级：

• 项目级 .vscode/ 目录：这里面藏着 launch.json（调试配置）、tasks.json（构建任务），以及项目专属的 settings.json（比如 "nodejs.debug.ja vascript.terminal.automaticallyClose": true 这种）。这个目录应该直接跟着代码一起提交到 Git 里，千万不要把它加到忽略列表里。
• 用户级 User 目录下的 keybindings.json 和 snippets/：比方说，你给 node 脚本写了个快捷代码片段 node:server，它就存在 snippets/ja vascript.code-snippets 文件里。这部分 settings.json 可管不着。
• Node.js 版本管理器配置（如 ~/.nvm/ 或 ~/.volta/）：VSCode 本身不会同步 nvm 的切换状态。如果你之前用 nvm use 18.17.0，那到了新机器上，就得手动安装同一个版本，再执行 nvm alias default 18.17.0。否则，launch.json 里写死了的 "runtimeExecutable": "~/.nvm/versions/node/v18.17.0/bin/node" 就会变成一条死路。

导出插件列表时，版本号一定带上

Node.js 生态里的插件对版本号极其敏感。举个例子：

• ms-vscode.vscode-typescript-next@6.0.0-dev.20260615 和稳定版 @5.5.4，在处理 TSX 文件时的行为完全不同。
• esbenp.prettier-vscode@14.12.1 依赖特定的 Node.js ABI。换了机器之后，如果 Node.js 版本对不上，插件图标就会消失，日志里会报 Cannot find module './extension'。
• dbaeumer.vscode-eslint 这个 ID 已经废弃了，新版是 eslint.vscode-eslint。如果用旧列表去恢复，肯定会失败。

正确的导出命令是这样的：
code --list-extensions --show-versions > node-extensions.txt
恢复的时候，加上 --force 参数并设定超时：
while read ext; do timeout 90 code --install-extension "$ext" --force || true; done < node-extensions.txt

SSH 远程开发中的 Node.js 环境，处理方式不同

如果你是通过 Remote-SSH 连到 Linux 服务器做 Node.js 开发，那情况又不一样了。你本地的 VSCode 配置只是“客户端”，真正执行 node 命令的是远程机器。这时候，备份的重点就得转移：

• 远程服务器上的 ~/.nvm 或者 /usr/local/bin/node 的路径，必须和之前保持一致，否则 launch.json 里的 runtimeExecutable 肯定失效。
• %USERPROFILE%\.ssh\config 文件必须备份。里面很可能有 Host my-node-server 加上 SetEnv NODE_ENV=development 这样的关键环境透传设置。
• 远程服务器上 ~/.bashrc 或 ~/.zshrc 中的 export PATH 行，决定了 VSCode Remote 终端能不能找到 node。这部分内容没法通过 Settings Sync 同步，必须手动复制，或者纳入 Ansible 这类自动化脚本里。

最容易翻车的其实是：Remote-SSH 恢复连接后，第一次打开终端时，shell 配置文件并不会自动加载。得手动执行一下 source ~/.zshrc，或者干脆重启远程的 VS Code Server（用 F1 → Remote-SSH: Kill VS Code Server on Host 这个操作）。