VSCode升级后node命令失效的根本原因是进程未重载shell环境，需彻底退出并重启：macOS右键Dock选Quit，Windows结束所有Code.exe进程，再通过终端执行code .启动以继承当前shell环境变量。
VSCode升级后终端里node命令失效
根本不是配置丢了，是VS Code进程没重载shell环境——它启动时读的PATH快照还停留在旧版本。macOS/Linux用户尤其容易卡在~/.zshrc没被加载，Windows用户则常因nvm-windows切换后NODE_HOME没广播到GUI进程。
实操建议：
- 关掉所有VS Code窗口，**完全退出进程**：macOS右键Dock图标选Quit；Windows进任务管理器结束所有
Code.exe进程 - 重新从终端启动（推荐）：
code .——这样它能继承当前shell的PATH、NVM_BIN、volta home等全部变量 - macOS如果仍不行，检查
~/.zshrc是否真被读取：echo $PATH里有没有~/.nvm/versions/node/...；没有就补source ~/.nvm/nvm.sh - Windows用nvm-windows的，每次
nvm use后，在VS Code里按Ctrl+Shift+P→ 输入Terminal: Reload Shell Environment，别只关tab
调试器仍跑旧版Node
终端里node -v是对的，但F5断点不生效或process.version显示旧版本？说明调试器压根没走你nvm切换的路径——它查的是VS Code启动那一刻的PATH，和终端无关。
实操建议：
- 打开VS Code设置（
Cmd+,），搜terminal.integrated.inheritEnv，设为true；改完必须完全退出再重开 - 确认
launch.json里没硬编码路径，优先用环境变量："runtimeExecutable": "${env:NVM_BIN}/node"（nvm）或"runtimeExecutable": "${env:VOLTA_HOME}/bin/node"（volta） - 在集成终端里运行
echo $NVM_BIN，确保有输出；没输出说明nvm根本没加载，得先修~/.zshrc或VS Code启动方式 - 不用nvm/volta的，直接删掉
runtimeExecutable字段，让调试器走默认PATH查找逻辑
自动补全和跳转失效
node能跑、npm能装，但require不提示、Ctrl+Click跳不到定义？这不是Node环境问题，是VS Code语言服务没识别项目结构。
实操建议：
- 项目根目录下必须有
jsconfig.json（JS）或tsconfig.json（TS），至少含：{"compilerOptions": {"allowJs": true}} -
package.json里加"type": "module"或"type": "commonjs"，否则模块解析会错乱 - 禁用所有第三方JS/TS增强插件（比如某些“Smart JS”类），VS Code内置的语言功能足够，插件冲突反而导致跳转失败
- 重启VS Code后，按
Cmd+Shift+P→Developer: Restart Language Server，强制刷新类型服务
npm命令在终端里报command not found
node能用但npm不行，大概率是npm没和node装在同一级目录，或者PATH只加了node路径没加npm所在目录。Homebrew装的node通常把npm放在/opt/homebrew/bin，Windows默认installer却可能漏掉npm路径。
实操建议：
- 原生终端运行
which npm（macOS/Linux）或where npm（Windows），确认真实路径 - 如果
which node返回/opt/homebrew/bin/node，但which npm返回/opt/homebrew/bin/npm，说明PATH里已经包含该目录，问题出在VS Code没继承——回到第一个副标题处理 - Windows手动加PATH时，别只加
C:\Program Files\nodejs\，还得加C:\Program Files\nodejs\node_modules\npm\bin\ - 临时救急：在VS Code终端里运行
export PATH=$PATH:/opt/homebrew/bin（macOS/Linux）或set PATH=%PATH%;C:\Program Files\nodejs\node_modules\npm\bin（Windows）
