VSCode中node命令报command not found是因未加载shell初始化文件导致PATH缺失node路径；macOS/Linux需将which node输出路径加入~/.zshrc并重启VSCode，Windows需在系统环境变量PATH中添加Node.js安装路径。
VSCode里node命令报command not found
根本不是插件或设置的问题，是VSCode没加载shell的初始化文件，PATH里压根没有node路径。终端里node -v能跑，但VSCode内置终端报错，就说明它启动时没读~/.zshrc（macOS）或~/.bash_profile（Linux），Windows则是系统PATH漏了C:\Program Files\nodejs\。
- macOS/Linux：运行
which node，把输出路径（比如/opt/homebrew/bin/node）加进~/.zshrc的export PATH="...:$PATH"里，改完必须彻底退出VSCode（关所有窗口），再从终端执行code .启动 - Windows：打开“系统属性 > 高级 > 环境变量”，检查“系统变量”里的
PATH是否含C:\Program Files\nodejs\；没加就手动添，或者重装Node.js并勾选“Add to PATH” - 验证方式：VSCode里按
Ctrl + `打开内置终端，直接输node -v——没输出就别往下配launch.json，全是白忙活
launch.json中program字段总指向错误文件
program是调试器找入口的唯一依据，写错路径、混用源文件和编译后文件、忽略工作目录，断点就永远停不住。
- 单文件测试用
"program": "${file}"最安全 - 后端项目必须显式写绝对路径，比如
"program": "${workspaceFolder}/src/server.js" - TypeScript项目：
program必须指向.js文件（如dist/server.js），不能指src/server.ts；同时tsconfig.json里得有"sourceMap": true，且.js.map和.js在同一目录 - ESM项目：
package.json必须含"type": "module"，否则调试器按CommonJS解析，import路径全错 - 加
"cwd": "${workspaceFolder}"显式声明工作目录，避免require('./config')因路径解析失败而报Cannot find module
用code-runner跑JS中文乱码或卡住
这个插件默认用node执行，但不传参、不设编码、也不捕获错误流，遇到中文路径或异步代码容易假死。
- 在VSCode设置里搜
code-runner.executorMap，找到javascript对应项，改成："node --experimental-specifier-resolution=node $fileName"（适配ES Module） - Windows防乱码加
-r utf-8参数："node -r utf-8 $fileName" - 别用它跑带
process.stdin的交互式脚本——code-runner不支持输入，换debugger或终端手动跑
调试时断点不生效，提示“Cannot launch program because corresponding JavaScript cannot be found”
这是VSCode的vscode-js-debug找不到源映射或入口文件，常见于用了import但没配"type": "module"、TS编译后路径错位、或program指向了不存在的文件。
- 确认
package.json有"type": "module"，否则import会被当CommonJS处理，路径解析全乱 - TS项目检查
tsconfig.json是否生成了.js.map，且和.js同目录；outDir路径别写错 -
launch.json里program字段别用相对路径如"./src/index.js"，优先用${workspaceFolder}拼接绝对路径 - Webpack打包项目：确保
devtool: 'source-map'开启，且output.path和sourceMapFilename匹配
最容易被忽略的是：调试器对模块类型极其敏感，type字段写错或缺失，哪怕其他都对，断点也进不去。
