VSCode本身不自动切换Node环境，需通过nvm配合.nvmrc声明版本，并在launch.json中显式配置"runtimeExecutable": "${env:NVM_BIN}/node"，同时启用terminal.integrated.inheritEnv为true并完全重启VSCode方可生效。
VSCode 本身不直接“切换 Node 环境”，它只是调用你系统里已有的 node 可执行文件。真正起作用的是你终端里生效的 node 路径，以及调试器、任务、扩展读取的配置。关键不是 VSCode 做了什么，而是你让哪个 node 在哪个上下文里被找到、被调用。
用 nvm + .nvmrc 实现项目级自动切换
这是最可靠、最符合工程实践的方式：每个项目声明自己依赖的 Node 版本，进入目录时自动生效。
-
.nvmrc文件必须放在项目根目录下，内容只写版本号（如v18.17.0或18.17.0），不能带空格或注释 - 确保终端启动时已加载 nvm：检查
~/.zshrc或~/.bash_profile中有类似export NVM_DIR="$HOME/.nvm"和[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"的行 - VSCode 终端默认继承 shell 环境，但如果你用的是“集成终端”且没重启过，可能仍用旧 PATH —— 关闭所有终端标签页，再打开一个新的，运行
nvm current验证是否匹配.nvmrc - 不要依赖插件“自动触发
nvm use”，很多插件只改终端启动命令，不改 VSCode 后台进程（比如 TypeScript 语言服务、ESLint 插件）所用的 Node
VSCode 调试时 nodePath 不生效？看 launch.json 配置
调试器（Debugger）默认用系统 PATH 下的 node，settings.json 里的 runtimeExecutable 对调试无效，必须显式写进 .vscode/launch.json。
- 在项目中按
Ctrl+Shift+P→ 输入Debug: Open launch.json创建配置 - 添加或修改
configurations中的runtimeExecutable字段，指向你想要的node二进制路径，例如："runtimeExecutable": "/Users/you/.nvm/versions/node/v16.20.2/bin/node" - 如果用的是
node自带的inspector模式（比如启动 Express 服务后 attach），runtimeExecutable依然有效；但如果是用npm run dev这类脚本启动，则该字段不参与控制 —— 此时靠终端环境 - 注意路径是绝对路径，Mac/Linux 区分大小写，Windows 要用正斜杠或双反斜杠，例如：
"C:\Program Files\nodejs\node.exe"
终端里 nvm use 有效，但 npm install 仍报错？检查 npm link 和全局 bin
即使 nvm use 18.17.0 成功，npm 命令本身可能来自另一个 Node 安装路径，导致全局模块冲突或 npm link 失败。
- 运行
which node和which npm，确认两者来自同一目录（如都出自~/.nvm/versions/node/v18.17.0/bin/） - 如果
npm是独立安装的（比如通过 pkg 或 Homebrew 单独装的），它会忽略 nvm 切换 —— 必须卸载它，只用 nvm 管理的npm -
nvm reinstall-packages <old-version>可迁移旧版本的全局包，但更推荐清空：先nvm use <target>，再npm install -g <needed-packages>显式重装 - VSCode 扩展如 ESLint、Prettier 若报“Cannot find module 'eslint'”，大概率是因为它们启动时用了 VSCode 内置的 Node（常为旧版），此时需在
settings.json中加："eslint.runtime": "/path/to/your/node"
远程开发（SSH）时 node 版本不一致？PATH 初始化被跳过
VSCode Remote-SSH 启动 server 时，不会 source 你的 ~/.zshrc，所以 nvm 不可用，node 回退到系统默认（通常是 /usr/bin/node）。
- 在远程服务器的
~/.bashrc或~/.zshrc末尾添加：export NVM_DIR="$HOME/.nvm"; [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" - 然后在 VSCode Remote-SSH 设置里启用：
"remote.ssh.enableAgentForwarding": true（非必需，但有助于密钥复用） - 最关键一步：在远程服务器上运行
code --install-extension ms-vscode.js-debug等核心扩展，确保它们也使用你指定的 Node —— 因为远程 extension host 进程由 VSCode server 启动，它只读$PATH，不读 shell 配置 - 验证方式：打开远程终端，输入
echo $PATH，确认 nvm 的 bin 目录排在最前；再执行node -v看是否为你期望的版本
最容易被忽略的一点：VSCode 的“设置同步”会把本地 settings.json 里的 runtimeExecutable 同步到其他设备，而路径显然不通用。一旦开启同步，务必在每台机器上手动覆盖该字段，或干脆禁用同步该配置项。
