先确认残留路径再重装：运行where node（windows）或which node（macos/linux），若指向已删除目录则说明残留未清；需彻底清理旧安装路径、环境变量path、npm缓存（npm cache clean --force），并重启vscode验证node -v报command not found才算干净。
node -v 还在报旧版本？先确认残留路径在哪
重装 Node.js 前必须知道：VSCode 本身不带 Node，它只是调用系统 PATH 里的 node。所以你看到的“重装无效”，90% 是因为旧路径还卡在环境变量里，或者残留文件没清干净。
先打开系统终端（不是 VSCode 内置终端），运行：
where node
（Windows）或
which node
（macOS/Linux）。如果输出路径指向一个已删除的目录（比如 C:Program Files
odejs 或 /usr/local/bin/node），说明残留没清完。
- Windows 用户重点检查：
C:Program Files odejs、C:Users\AppDataRoaming pm、C:Users\AppDataRoaming pm-cache - macOS/Linux 用户重点检查：
/usr/local/lib/node_modules、~/.nvm、/usr/local/bin/node和/usr/local/bin/npm - 别漏掉
npm cache clean --force—— 缓存里可能存着旧版本模块的二进制绑定，不强制清空，重装后npm install会静默复用，导致 ABI 不兼容崩溃
删完残留后，PATH 里还有旧路径怎么办
环境变量 PATH 是最常被忽略的“隐形残留”。哪怕文件夹删了，只要 PATH 里还留着那行，终端就永远能调起不存在的 node，而且报错是“找不到模块”而非“命令未找到”，非常误导人。
Windows 用户请打开“系统属性 → 高级 → 环境变量”，在“系统变量”和“用户变量”的 Path 里逐条检查，删掉所有含 nodejs、npm 或疑似旧安装路径的条目（尤其注意带空格或中文的路径，如 C:Program Files
odejs）。
macOS/Linux 用户检查 ~/.zshrc 或 ~/.bash_profile，删掉类似 export PATH="/usr/local/bin:$PATH" 这种硬编码路径 —— 它可能指向已被删掉的 Homebrew 安装。
- 改完 PATH 后，必须完全关闭所有 VSCode 窗口，再重新打开项目文件夹；内置终端不会自动刷新环境变量
- 验证是否生效：在新打开的 VSCode 终端里运行
echo $PATH（macOS/Linux）或path（Windows），确认旧路径已消失 - 此时再运行
node -v应该直接报command not found，这才是清理干净的标志
重装时最关键的三个动作
重装 ≠ 双击安装包点“下一步”。真正决定后续是否顺的关键动作只有三个：
- Windows 安装时务必勾选 Add to PATH —— 不勾就等于白装，手动加 PATH 极易出错
- 安装路径别用默认的
C:Program Files odejs（含空格），推荐C: odejs或D: odejs；macOS/Linux 若用官网 pkg 安装，路径会固定在/usr/local/bin，无需额外操作 - 装完立刻在系统终端（不是 VSCode）里跑
node -v和npm -v—— 只有这两个都输出版本号，才算安装成功；VSCode 里的结果只是继承这个状态
如果用 nvm/fnm/volta 等版本管理器，跳过官网安装，直接用它们装新版本即可，但记得在 launch.json 的 runtimeExecutable 字段里显式写死路径，否则 VSCode 调试器识别不了切换逻辑。
VSCode 调试器找不到 node 怎么办
终端能跑 node ≠ VSCode 调试器能用 node。调试器依赖 launch.json 里的 runtimeExecutable 或全局 PATH，但 PATH 查找顺序和终端不完全一致，尤其当有多个版本共存时。
最稳妥的做法是：在项目根目录新建 .vscode/launch.json，配置项中明确指定路径：
{
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Launch",
"runtimeExecutable": "/usr/local/bin/node",
"program": "${file}"
}
]
}
（macOS/Linux 示例；Windows 路径写成 "C:\nodejs\node.exe"）
- 删掉
runtimeExecutable字段会让调试器按 PATH 顺序找，风险高；保留它才能锁定版本 - 配合
console.log(process.execPath)在代码里打印实际执行路径，和runtimeExecutable对比，能快速定位是否调用了预期版本 - 如果用了 TypeScript，别用
ts-node直接启动调试 —— 改用node --loader ts-node/esm模式，并在runtimeArgs中配置，否则断点不生效
重装不是一键操作，而是路径、缓存、环境变量、调试配置四层清理+验证。最容易被跳过的其实是 npm cache clean --force 和重启 VSCode —— 这两个动作不做，90% 的“重装失败”都会复现。
