vscode中npm run build报“command not found”根本原因是集成终端未加载shell配置，导致path缺失npm路径；macos/linux需在~/.zshrc中添加export path并source生效，windows需将node.js和%appdata%\npm加入系统环境变量，且必须彻底重启vscode验证。
VSCode里Node环境报编译错，八成不是代码问题，而是终端没加载到正确的Node环境或构建命令压根没跑起来——先别改代码，得让VSCode“认得”你装的node和npm。
终端里node -v能用，但npm run build就报“command not found”
这说明VSCode集成终端（Ctrl + `）启动时没读取你的shell配置文件（比如~/.zshrc或~/.bash_profile），PATH里缺npm路径。macOS/Linux用户常见于Homebrew安装后没把/opt/homebrew/bin或~/.npm-global/bin加进PATH；Windows用户则常因Node.js安装时没勾选“Add to PATH”导致npm.cmd不在系统路径中。
- 在VSCode内置终端执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认输出里包含Node.js安装目录和npm全局路径 - macOS/Linux：检查
~/.zshrc是否含export PATH="$HOME/.npm-global/bin:$PATH"，改完运行source ~/.zshrc，再彻底退出VSCode（Activity Monitor里杀掉所有Code进程），从终端用code .重启 - Windows：打开系统环境变量设置，把
C:\Program Files\nodejs\和%APPDATA%\npm都加进“系统变量”或“用户变量”的PATH里 - 验证：重启后在VSCode终端里分别执行
node -v和npm -v，两个都得有输出
tasks.json里g++/tsc/npm命令找不到
tasks.json里的command字段必须是PATH里可直接调用的命令名，不能带路径（如./node_modules/.bin/tsc），也不能写成相对路径（如node_modules/.bin/tsc）。VSCode不会自动帮你展开node_modules/.bin软链，它只认PATH里的可执行名。
- 确认
command值是纯命令名："command": "tsc"✅，"command": "./node_modules/.bin/tsc"❌ - 如果项目依赖本地安装的工具（比如
typescript），确保已执行npm install且node_modules/.bin被加入PATH（macOS/Linux可通过export PATH="./node_modules/.bin:$PATH"临时加，Windows需手动配） - Windows下
npm有时会卡在npm.cmd找不到，tasks.json里可显式写"command": "npm.cmd"绕过 - 用
which tsc（macOS/Linux）或where tsc（Windows）查真实路径，再比对PATH是否覆盖该位置
“Cannot find module”但node -e "require('xxx')"能跑
这个错通常出现在VSCode调试或任务运行时，和终端里手动跑的结果不一致——根本原因是Node.js模块解析路径不同。调试器或tasks.json启动的进程可能没继承你终端的NODE_PATH，也没自动加载node_modules，尤其当项目结构含monorepo或多层node_modules时更易出错。
- 检查
launch.json里有没有误设NODE_PATH环境变量，它会强制覆盖默认解析逻辑，删掉试试 - 确认
program字段指向的是编译后的真实JS入口（如"${workspaceFolder}/dist/index.js"），而不是TS源码；否则require会按TS路径解析，找不到对应JS文件 - monorepo项目（如pnpm workspace）：在
tasks.json的options里加"cwd": "${workspaceFolder}/packages/my-app"，确保工作目录正确 - 调试时想看模块加载路径，可在
launch.json里加"env": {"NODE_OPTIONS": "--trace-warnings"}，错误输出里会打印module resolution过程
真正卡住人的往往不是语法错，而是VSCode启动的每个子进程（终端、task、debugger）各自加载PATH和环境变量的方式不统一。同一台机器上，终端能跑通不代表task能跑通，task能跑通也不代表debugger能跑通——得一个个验证，不能假设它们共享环境。
