VSCode调试器报“Command 'node' not found”是因为GUI启动未继承shell PATH：macOS/Linux需终端执行code --no-sandbox .启动，Windows需安装时勾选“Add to PATH”并验证内置终端node -v和npm -v双输出。
VSCode 本身不配置 Node.js 环境，它只调用你系统里已装好的 node 和 npm；所谓“配置成功”，就是让终端能跑 node -v、调试器能断点、require() 不报错——三者缺一不可。
为什么 VSCode 终端能运行 node，但调试器报 Command "node" not found
这是 Windows/macOS/Linux 上最常被误判为“VSCode 配置问题”的真实故障点：GUI 启动的 VSCode 没继承 shell 的 PATH。
- macOS/Linux：从 Dock 或 Spotlight 启动 VSCode，不会加载
~/.zshrc或~/.bash_profile；改完配置后只source ~/.zshrc不够，必须 重启 VSCode，或更可靠地——在终端里执行code --no-sandbox . - Windows：Node.js 安装时没勾选 “Add to PATH”，或安装路径含中文/空格（如
C:\Program Files\nodejs\是合法的，但C:\我的软件\nodejs\会导致npm静默失败） - 验证方式：在 VSCode 内置终端（
Ctrl+`）中直接敲node -v和npm -v，双输出才有继续调试的价值
launch.json 中 program 字段写什么才不翻车
program 字段不是“随便填个入口文件就行”，它决定调试器真正执行哪段 JS，填错就等于让调试器对着空气下断点。
- 单文件快速调试：用
"program": "${file}"—— 这表示“当前打开的文件”，适合写 demo 或临时脚本 - 项目级稳定调试：明确指向真实入口，比如
"program": "${workspaceFolder}/dist/index.js"（TS 构建后）或"program": "${workspaceFolder}/src/index.ts"（配合sourceMaps和编译任务） - 绝对不要写死路径如
"program": "C:/project/index.js"—— 跨平台失效、团队协作崩盘 - 调试
npm start？把"program"改成"npm"，再加"args": ["start"]和"console": "integratedTerminal"，否则看不到启动日志
require() 报 Cannot find module，真不是环境没配好
这问题八成和 VSCode 的语言服务有关，跟 node 命令能否运行无关。Node.js 运行时其实已经找到了模块，只是编辑器提示红波浪线、跳转失效、自动补全挂了。
- 先确认模块真实存在：
npm ls <module-name></module-name>，看有没有extraneous标记（说明安装异常） - monorepo 场景（如 pnpm workspace）：确保
jsconfig.json或tsconfig.json里有"baseUrl": "."和"paths"映射 - 软链接依赖（
npm link）：VSCode 默认不跟随 symlink，需在jsconfig.json中加"compilerOptions": { "moduleResolution": "node" } - ESM/CJS 混用：
package.json缺"type": "module"时，import会失败，但require()可能正常——别靠报错反推环境问题
断点命中但变量显示 undefined 或源码错位
这不是代码逻辑问题，是 source map 没对齐或调试器没读到正确映射文件。
- TS 项目：确保
tsc --build生成了.map文件，且launch.json中启用了"sourceMaps": true - Webpack/Vite：检查构建配置是否输出
devtool: 'source-map'，并确认output.path和launch.json中program路径一致 - 常见陷阱：构建产物放在
dist/，但launch.json仍指向src/；或outDir设为./lib，但sourceMapPathOverrides没同步更新 - 调试器读不到
.map？在 Debug Console 手动执行console.log(__filename)，比对路径是否和sources字段匹配
真正卡住人的从来不是“怎么装插件”，而是 node 命令在终端里能跑，却在调试器里消失；或是 require 在命令行里成功，VSCode 却标红。这些缝隙里的细节，才是全栈开发环境稳不稳的分水岭。
