vscode终端报“command not found”根本原因是图形界面启动未加载shell配置（如~/.zshrc），导致path缺失；需设terminal.integrated.shellargs为["-l"]、验证echo $path、彻底重启vscode，并在launch.json中用env字段补全path。
VSCode终端报“command not found”，但系统终端能跑node -v
根本不是Node没装，而是VSCode图形界面启动时没加载你的shell配置（比如~/.zshrc）。macOS/Linux下双击图标启动的VSCode默认走non-login shell，跳过所有export PATH=...逻辑。
验证方法：在VSCode终端里执行echo $PATH，对比系统终端输出。如果缺了/usr/local/bin、/opt/homebrew/bin或你自定义的Node路径，就坐实了问题。
- 临时解法：在VSCode设置里搜
terminal.integrated.shellArgs，设为["-l"]（小写L），强制走login流程 - 改完必须彻底退出VSCode（macOS右键Dock选「退出」，Windows用任务管理器杀光
Code.exe），再重新打开 - 如果
~/.zshrc开头有[[ -n $ZSH_EVAL_CONTEXT ]] && return这类防护，它会提前退出——加一句echo "zshrc loaded"就能验证是否真被读取
调试时F5报“找不到Node.js二进制文件'node'”
终端能用≠调试器能用。VSCode调试器（launch.json）启动的是全新进程，完全不继承终端环境变量——它的PATH是空的，除非你手动喂进去。
-
launch.json里不能写environment（已弃用），得用env字段："env": { "PATH": "${env:PATH}:/usr/local/bin" } - Windows下路径拼接用
;，Linux/macOS用:；平台键要写对：terminal.integrated.env.windows、.linux、.osx - 别在
configurations外层写env，那位置无效；也别指望envFile自动补PATH，它只读.env里的键值对 - 如果你用
nvm或fnm，删掉runtimeExecutable硬编码，让调试器走默认查找路径
Windows下PowerShell里npm提示“无法将'npm'项识别为cmdlet”
这不是权限问题，而是VSCode继承了错误的PATH：要么Node安装时漏选“Add to PATH”，要么你用nvm-windows装在非默认路径（比如D:
vm4w
odejs），但系统PATH里没填这个位置。
- 先查真实Node路径：
where node（CMD）或Get-Command node（PowerShell），确认输出是不是C:Program Files odejs ode.exe或D: vm4w odejs ode.exe - 去系统环境变量面板，把正确路径加到“用户变量”的
PATH里（别只加系统变量，普通用户登录时不一定继承） - 若用
nvm-windows，推荐在VSCode设置JSON里直接补PATH："terminal.integrated.env.windows": { "PATH": "${env:PATH};D:\nvm4w\nodejs" } - 注意分隔符是
;，不是:；${env:PATH}必须保留，否则连notepad都打不开
团队协作时成员开箱即用却总断点失败
靠口头约定或文档说明不如直接把规则固化进项目。.vscode/launch.json和settings.json不是可选项，是必须存在的基础设施。
-
launch.json里program字段设为"${file}"（而非固定文件名），否则每次换文件都要改配置 - 如果项目用
ts-node或esbuild-node启动TS文件，断点必然失效——改用node --loader ts-node/esm模式，并在runtimeArgs里显式写入 - 不要硬编码
runtimeExecutable，除非你明确用nvm/fnm；删掉这行，让调试器走默认查找路径 -
settings.json里加"terminal.integrated.shellArgs": ["-l"]（macOS/Linux）或"terminal.integrated.env.windows"（Windows），确保新成员拉代码后一开VSCode就生效
最常被忽略的是：改完settings.json或launch.json后，不关掉所有终端标签页、不重启VSCode窗口，就以为配置生效了——其实没用。
