vscode终端中node -v报错的根本原因是其集成终端未继承shell环境变量，需验证which node是否返回路径、确保path已正确配置并彻底重启vscode，同时launch.json的program字段必须使用绝对路径如"${workspacefolder}/app.js"。
VSCode 里测试 Node 环境连接性，本质是验证 node 和 npm 是否真能在 VSCode 自身的终端中执行——不是系统终端能跑就行，VSCode 的集成终端必须能认。
为什么 node -v 在系统终端成功，VSCode 里却报错？
VSCode 内置终端（Ctrl + `）可能用的是不同 shell：Windows 默认 PowerShell，macOS 可能是 zsh，Linux 可能是 bash。它们的 PATH 不一定继承你手动配好的环境变量。
- 在 VSCode 里按
Ctrl + `打开终端，立刻运行which node（macOS/Linux）或where node（Windows），看是否返回路径（如/usr/local/bin/node或C:\Program Files\nodejs\node.exe） - 如果报 “command not found”，说明 VSCode 没读到 Node 安装目录——重装 Node.js 时没勾选 Add to PATH；macOS 用 Homebrew 安装的，需确认
~/.zshrc里有export PATH="/opt/homebrew/bin:$PATH"并已执行source ~/.zshrc -
npm -v也必须同时成功，否则后续调试器调用 npm 脚本（比如nodemon）会静默失败
launch.json 里最常卡死的路径问题
VSCode 调试器对 program 字段极其敏感，写错一个字符、漏掉 ${workspaceFolder}、路径用了相对而非绝对，断点就全灰。
VSCode 1.118
下载
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 入口文件如果是
app.js，program必须写成"${workspaceFolder}/app.js"，不能只写"app.js"或./app.js - 项目结构是
src/server.js？那就得写"${workspaceFolder}/src/server.js"，别指望自动解析 -
cwd（工作目录）建议显式设为"${workspaceFolder}"，否则require('./config')或dotenv加载.env会失败
断点不生效？先查 --inspect 是否真启用
VSCode 调试器依赖 Node.js 的 V8 Inspector 协议（--inspect），它从 Node.js 8.0+ 开始默认开启。但旧版本或某些启动方式会绕过它。
- 终端运行
node -v，确认 ≥v8.0.0；若低于，升级 Node 或在launch.json中指定runtimeExecutable指向新版node路径 - 不要在
runtimeArgs里手动加--inspect—— VSCode 会自动注入，重复加会导致端口冲突（错误：address already in use） - 用
nodemon？必须加--inspect-brk参数启动进程，且launch.json改用attach模式，不能用launch直接跑nodemon
真正卡住的往往不是配置多复杂，而是 which node 在 VSCode 终端里没输出、program 路径少了个斜杠、或者以为 npm start 能直接 debug 却没配 console: "integratedTerminal" 导致输出看不见——这些细节不验一遍，调试永远起不来。
