VSCode调试断点不生效、智能提示失效等根本原因是调试器与终端环境加载逻辑不同：调试器不继承shell配置，需手动配置launch.json的program、runtimeExecutable及sourceMaps，且语言服务依赖jsconfig.json或tsconfig.json正确配置。
VSCode 里 node 命令能跑，但调试断点不生效、自动补全失效、甚至 launch.json 报错“Cannot find runtime 'node'”，根本不是插件没装对，而是环境配置逻辑被误解了。
为什么终端能用 node，但 VSCode 调试器找不到 node
VSCode 的调试器（Debugger）和内置终端（Terminal）加载环境的方式完全不同：终端会读取你的 shell 初始化文件（如 ~/.zshrc），而调试器默认只查系统 PATH 或 launch.json 里硬写的 runtimeExecutable。
- macOS/Linux：改完
~/.zshrc后，必须彻底退出 VSCode（不只是关窗口），再从终端执行code .启动，否则调试器仍看不到新 PATH - Windows：如果安装 Node.js 时没勾选 “Add to PATH”，调试器就完全找不到
node.exe；手动添加后需重启 VSCode，且要确认是“系统变量”而非“用户变量” - 用了
nvm/fnm：调试器不执行 shell 切换逻辑，runtimeExecutable必须写死路径，比如"~/.nvm/versions/node/v20.15.0/bin/node"
launch.json 中 program 字段写错的典型表现
program 是调试器启动进程的唯一入口，写错就等于让调试器“去一个不存在的地址敲门”。常见错误不是语法错，而是语义错。
- TS 项目写
"program": "${workspaceFolder}/src/server.ts"→ 必须指向编译后的.js文件，比如"dist/server.js" - ESM 项目没在
package.json里设"type": "module"→ 调试器按 CommonJS 解析，import全报错 - 用
nodemon时硬塞runtimeExecutable: "nodemon"→ 断点必然失效；正确做法是删掉这行，改用request: "attach"模式，先终端跑nodemon --inspect-brk src/server.js，再连过去 - 忽略
cwd→require('./config')因工作目录不对而报Cannot find module，加一句"cwd": "${workspaceFolder}"就解决
智能提示失效，真不是 Node.js 环境问题
只要 node -v 和 npm run dev 能跑，说明 Node.js 运行时没问题。补全/跳转/类型提示挂了，90% 是 VSCode 没识别出项目结构或语言服务被干扰。
- JS 项目缺
jsconfig.json：哪怕只是空对象{}，也能激活基础语言服务 - TS 项目
tsconfig.json里没开"sourceMap": true→ 调试时无法映射源码，断点打在.ts上无效 - 禁用所有非官方 JS/TS 插件：像 “JavaScript (ES6) code snippets” 这类老插件会和内置语言服务冲突，导致跳转失败
-
files.associations配错：比如把.mjs关联到"javascript"却没配 ESM 支持，类型推导直接崩
最常被忽略的是：VSCode 的调试器和语言服务各自有一套环境加载逻辑，不能靠“终端能跑”来推定“调试能行”或“提示能出”。每个环节都要单独验证——node -v 在终端、node -v 在调试控制台、Go to Definition 能否跳转，三者可能全部不同步。
