VSCode终端运行node命令依赖系统Node.js安装和PATH环境变量，修改PATH后必须重启VSCode；终端默认路径非当前项目，需手动cd；ES模块需package.json设"type":"module"；调试应固定program路径而非"${file}"。
VSCode终端能直接运行 node 命令，不是靠插件“配出来”的，而是依赖系统级的 Node.js 安装和环境变量生效。90% 的“终端报错 not recognized”问题，根源都在 PATH 没刷进 VSCode 进程里。
终端打不出 node -v？先确认系统 PATH 是否真正生效
VSCode 启动时会固化一份环境变量快照，改完系统 PATH 不重启编辑器，内置终端永远找不到 node。
- 在系统终端（Windows 的 CMD/PowerShell、macOS/Linux 的 Terminal）里执行
node -v和npm -v，两者都输出版本号才算过关 - Windows 用户检查安装时是否勾选了 “Add to PATH”；没勾选就手动把 Node.js 安装目录（如
C:\Program Files\nodejs）加进系统环境变量Path - macOS/Linux 用
nvm的，确认source ~/.nvm/nvm.sh已写入~/.zshrc或~/.bash_profile，且新开系统终端能识别nvm - 改完 PATH 后，必须彻底关闭 VSCode 所有窗口再重开——只关标签页或窗口无效
npm init 没反应？终端当前路径大概率错了
VSCode 内置终端默认不自动切换到你打开的文件夹，它可能停在用户主目录、上一个项目，甚至桌面。
- 按
Ctrl + `唤出终端后，立刻执行pwd（macOS/Linux）或cd（Windows），看输出路径是不是你的目标项目根目录 - 如果不是，用
cd /your/project/path切过去，再运行npm init -y - 别信右键菜单里的「在终端中打开」——某些 VSCode 版本会打开错误工作区，尤其从资源管理器拖入文件夹时
运行 import/export 报错？package.json 少了 type 字段
Cannot use import statement outside a module 不是语法错，是 Node.js 默认按 CommonJS 解析，而你写了 ES Module 语法。
- 初始化时一步到位：
npm init -y && npm pkg set type=module（要求 Node.js ≥ 14.13） - 手动补：打开
package.json，在顶层加"type": "module"，注意逗号位置别破坏 JSON 结构 - 加了之后，所有
.js文件都走 ES Module 规则，require()会直接报错；反之没加，import就挂——二者不能混用 - Code Runner 插件不读
package.json，禁用它跑 Node 脚本；改用内置终端cd到项目根后执行node index.js
launch.json 调试失败？program 字段写 "${file}" 是最大陷阱
VSCode 自动生成的调试配置常设 "program": "${file}"，看着方便，实则极易翻车：你在 utils/helper.js 里点 F5，调试器真就只跑这个文件，没上下文、没 require 链，直接报 Cannot launch program because corresponding JavaScript cannot be found。
- 生产级写法：固定入口，比如
"program": "${workspaceFolder}/index.js"或"program": "${workspaceFolder}/src/index.js" - 如果用 TypeScript，
launch.json必须配"preLaunchTask": "tsc: build"，且"outFiles"指向编译后路径（如["${workspaceFolder}/dist/**/*.js"]） - Windows 用户注意：路径一律用
/，写\会触发转义，VSCode 内部自动处理，不用管本地系统分隔符
最易被忽略的是：Node.js 版本管理工具（如 nvm）切换版本后，VSCode 不会自动感知，which node 输出的路径和调试器实际调用的可能根本不是同一个——加一行 console.log(process.execPath) 对比验证，比猜强十倍。
