必须备份项目级.vscode/目录、用户级keybindings.json和snippets/、Node.js版本管理器配置，并导出带版本号的插件列表；仅备份settings.json无法恢复VSCode识别、运行、调试Node.js的完整能力。

直接备份 VSCode 的 Node.js 开发环境，不能只导出 settings.json 或只记下 node 路径——关键在于还原“VSCode 能正确识别、运行、调试 Node.js 代码”的完整链路。单纯恢复插件或设置，大概率导致终端报 command not found、调试器提示 Cannot find runtime 'node'、或者 TypeScript 跳转失效。

为什么 settings.json 备份后 Node.js 环境仍不工作

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 功能降级：

Zenlink - Node SDK for ZenHeart

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

• 项目级 .vscode/ 目录：含 launch.json（调试配置）、tasks.json（构建任务）、settings.json（项目专属设置，如 "nodejs.debug.javascript.terminal.automaticallyClose": true）。这个目录应随代码一起提交 Git，不要忽略
• 用户级 User 目录中的 keybindings.json 和 snippets/：比如你为 node 脚本定义的快捷代码片段 node:server，存在 snippets/javascript.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" 就是死路径

code --list-extensions 导出的插件列表要带版本号

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

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）。