根本原因是VSCode启动时未加载shell配置文件导致PATH缺失；macOS/Linux需设terminal.integrated.shellArgs为["-l"]启用登录shell，Windows需确认Node路径已加入系统环境变量并彻底重启VSCode。
终端里执行 node 命令失败，根本原因是什么
不是 VSCode 有问题，而是它启动时没读到你配好的 PATH。系统终端里 node -v 成功，但 VSCode 内置终端报 command not found: node，说明 shell 配置没生效。macOS/Linux 用户常见于 ~/.zshrc 没 source ~/.nvm/nvm.sh；Windows 用户则多因安装 Node.js 时没勾选 “Add to PATH”，或装在了含中文/空格的路径下。
验证方式：在 VSCode 终端里直接运行 which node（macOS/Linux）或 where node（Windows）。没输出 = 环境没加载。解决必须三步走：
- 彻底退出所有 VSCode 进程（macOS 在 Dock 右键「退出」，Windows 在任务管理器确认
Code.exe已结束） - 在系统终端（不是 VSCode 里的）确认
which node输出路径合理（如/usr/local/bin/node或C:\Program Files\nodejs\node.exe） - 双击图标重启 VSCode，按
Ctrl+`打开终端，立刻执行node -v—— 这次的结果才可信
tasks.json 配置不生效，90% 是路径和类型写错了
tasks.json 必须严格放在项目根目录下的 .vscode/ 文件夹中，放错位置（比如丢进 src/ 或漏掉 .vscode）就完全不会被识别。VSCode 不会自动向上查找，也不会提示配置缺失。
关键字段不能乱填：
-
"type": "shell"是必须项，用"process"会导致环境变量（如NODE_ENV、.env）丢失 -
"label"不能含空格，推荐写成"start:dev"而非"Start Dev Server" -
"command"要带完整路径或可执行名："npm"或"node"，别写成"./node_modules/.bin/npx"（除非显式"cwd"设对） - Windows 用户注意：
"args"中路径分隔符统一用/，混用\和/会导致解析失败
想让 npm run dev 在终端里自动打开并持续输出日志
默认任务面板只显示命令退出状态，不实时转发 stdout。服务启动后看不到 Listening on http://localhost:3000？那是 "presentation" 没配好。
必须加这几行：
"presentation": {
"echo": true,
"reveal": "always",
"panel": "dedicated",
"clear": true
}
其中 "echo": true 是硬性要求，不加就等于没输出；"panel": "dedicated" 避免和其他任务日志混在一起；"clear": true 每次运行前清空旧日志，防止误读残留信息。
如果脚本依赖 .env，别指望 dotenv 自动加载——任务不读 .env。得手动注入：
- 简单场景：
"env": { "NODE_ENV": "development" } - 需加载文件：
"args": ["-r", "dotenv/config", "index.js", "dotenv_config_path=.env"]
为什么 Ctrl+Shift+P → Tasks: Run Task 找不到你的任务
不是配置写错了，是 VSCode 没“认出”它是可运行任务。常见卡点：
- 项目根目录下没有合法的
package.json（文件损坏、BOM 头、JSON 格式错误都会导致识别失败） - 生成
tasks.json时选了 “Others” 模板，但没手动加"group": "build"或"group": "develop"，VSCode 就不把它归类为可触发任务 - 用了
"script": "dev"字段，但package.json里实际是"scripts": { "dev-server": "..." }，字段名不匹配 - 任务定义在
.vscode/tasks.json，但当前打开的工作区不是该项目根目录（即 VSCode 启动路径不对）
最稳做法：右键项目根目录 → “Generate tasks.json from template” → 选 “npm”，再检查生成内容是否包含 "script": "start" 且对应 package.json 中真实存在的 script 名。
真正容易被忽略的是：VSCode 的任务系统从不自动继承 shell 的 cd 行为。哪怕你在终端里 cd 到子目录，任务仍以 workspaceFolder 为起点执行。所以 "cwd" 字段不是可选项，而是必填项——尤其当你 require('./config/db') 时，路径错一点，模块就找不到。
