VSCode集成终端默认以non-login shell启动，不执行~/.zshrc等配置文件，仅在.settings.json中注入PATH无法触发nvm初始化，导致nvm current为空、$NVM_BIN未设置，进而使launch.json中${env:NVM_BIN}/node静默回退至系统Node。
为什么.vscode/settings.json单独配PATH没用
VSCode集成终端默认以non-login shell启动，根本不会执行~/.zshrc或~/.bash_profile里的nvm.sh加载逻辑。只在.vscode/settings.json里写"terminal.integrated.env.zsh"注入PATH，只是“声明变量”，不触发nvm use动作——新开终端后nvm current仍为空，which node还是指向/usr/bin/node。
真正生效的前提是：终端进程必须实际执行过nvm use或等效初始化。否则$NVM_BIN始终为空，后续所有依赖它的配置（比如launch.json里的${env:NVM_BIN}/node）都会静默fallback到系统默认Node。
- 验证方法：新开终端后立刻运行
nvm current和which node，两者输出必须一致且非空 - 不要把
nvm.sh的source行只放在~/.zshrc里——non-login shell不读它；得挪到~/.zsh_profile或显式用-l参数启动login shell - 如果项目根目录有
.nvmrc，确保shell初始化脚本末尾有nvm use自动触发逻辑，否则VSCode终端不会感知该文件
launch.json里runtimeExecutable必须动态取值
VSCode调试器（F5）启动时拍下的是进程启动瞬间的环境快照，和你在终端里刚执行的nvm use 20完全无关。终端里node -v显示v20.15.0，F5却跑v16.20.2，是常态，不是bug。
唯一可靠写法是在项目根目录的.vscode/launch.json中显式指定："runtimeExecutable": "${env:NVM_BIN}/node"。这个变量只有在终端已成功加载nvm的前提下才有效——如果nvm current失败，${env:NVM_BIN}展开为空，调试器就退回到/usr/bin/node。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 硬编码路径如
/home/user/.nvm/versions/node/v20.15.0/bin/node能跑通，但换机器、重装nvm或改用户名就失效 -
runtimeExecutable留空时，调试器只认PATH里的第一个node，而这个PATH来自VSCode启动时的父进程，不是你当前终端的 - 如果项目同时有
tasks.json，里面npm命令也会走同样逻辑——别指望nvm use手动切完就能让task也跟着变
多项目共存时.vscode/settings.json必须按项目写死
全局设置或用户级settings.json无法让frontend/和backend/各自用不同Node版本。它们共享同一套终端初始化流程，除非把环境加载逻辑下沉到每个项目内部。
实操做法是在每个项目根目录建.vscode/settings.json，内容按系统填入对应nvm路径和环境变量。VSCode工作区设置优先级高于全局，但它只影响该文件夹下的终端和调试器，不改变系统shell行为。
- Linux/macOS建议用
"terminal.integrated.env.zsh"，Windows用"terminal.integrated.env.windows"，避免跨平台变量名错位 - 路径里别用
${env:HOME}拼接NVM_DIR——多用户环境下$HOME可能解析失败，直接写绝对路径更稳 - 如果项目
package.json里有"engines": {"node": ">=18.0.0"}，可配合nvm install+nvm alias做绑定，但需手动触发，VSCode不自动检查
窗口级隔离必须用--user-data-dir
Cmd+Shift+N新建窗口只是共享会话的新视图，所有窗口共用同一套扩展进程、调试端口和环境变量。改一个窗口的settings.json，另一个马上同步；关掉一个，另一个可能丢断点。
真正物理隔离只有一条路：code --user-data-dir="/path/to/unique"启动。路径必须为空或不存在，VSCode才会初始化全新用户数据目录——包括独立的extensions缓存、keybindings.json和state.json。
- macOS要右键Dock图标→Quit，Windows要在任务管理器确认
Code Helper进程消失，否则--user-data-dir无效 -
--new-window参数没用，它不隔离环境，只开新UI视图 - 复杂项目必须分层：窗口级用
--user-data-dir隔离nvm上下文，工作区级用.code-workspace组织文件夹路径，项目级用.vscode/launch.json绑定调试器Node路径
nvm current到底是哪个时刻的状态。漏一层，node -v和F5就对不上。 
