VSCode本身不提供Node.js运行时，必须先安装系统级Node.js并确保PATH正确配置；node -v在系统终端成功但在VSCode中报错，根本原因是VSCode未继承更新后的PATH，需重启VSCode或通过终端启动code .解决。
VSCode 本身不带 Node.js，必须先装好 Node.js 并让终端真正识别 node 命令，否则所有后续操作都会失败。
node -v 在系统终端能用，但在 VSCode 终端报 command not found
这不是 VSCode 的 bug，而是环境变量没继承到位。VSCode 启动时读取的是它启动那一刻的 shell 环境，如果安装 Node.js 后没重启 VSCode，或者 PATH 没刷新，内置终端就找不到 node。
- 关掉所有 VSCode 窗口（macOS 在 Dock 右键选「退出」；Windows 在任务管理器里确认
Code.exe已结束） - 打开系统原生终端（不是 VSCode 里的），运行
which node（macOS/Linux）或where node（Windows），确认路径指向你安装的目录（如/usr/local/bin/node或C:\Program Files\nodejs\node.exe） - 再重新打开 VSCode，按
Ctrl + `打开内置终端，立刻执行node -v—— 这次的结果才可信 - Windows 用户重装 Node.js 时务必勾选 “Add to PATH”；macOS 若用 Homebrew 安装，检查
~/.zshrc是否包含export PATH="/opt/homebrew/bin:$PATH"
别信“Node.js 插件能装运行时”这种说法
你在扩展市场搜到的 Node.js Extension Pack、JavaScript (ES6) code snippets 等插件，只提供语法高亮、调试支持、代码片段，不包含 node 二进制文件本身。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 常见错误现象：
Cannot find module 'http'、ReferenceError: require is not defined、断点不生效、控制台空转后退出 - 根本原因：没有真正的 Node.js 运行时，插件只是“画饼”
- 必须去
nodejs.org下载 LTS 版本（当前是 v20.15.1），手动安装，再验证终端是否识别 - 不要用 ZIP 解压版直接扔进路径——它不会自动注册 PATH，容易漏掉
npm
先跑通 console.log，再碰 require('http')
新手常一上来就抄服务器示例，结果卡在模块加载或端口占用上，反而掩盖了最基础的 JS 执行问题。
- 新建一个
hello.js，内容只写一行：console.log("Hello World"); - 在 VSCode 终端里手敲
node hello.js（别用右键“Run Code”插件，它可能绕过路径校验） - 看到输出才算 JS 运行时通了；这时再建
server.js，用require('http')启服务 - 如果浏览器打不开
http://localhost:3000，先检查终端有没有打印Server running at...；没打印说明server.listen()没执行，不是代码错，是逻辑漏了 - 端口被占报
EADDRINUSE？改server.listen(4000)即可，别硬刚 3000
launch.json 的 program 字段别写死
VSCode 调试时自动生成的 launch.json 默认是 "program": "${workspaceFolder}/app.js"，你换文件名（比如改成 server.js）后 F5 就直接失败。
- 临时方案：把
program改成"${file}"，这样每次调试当前打开的 JS 文件 - 长期项目建议：固定入口文件（如
index.js），然后设为"${workspaceFolder}/index.js" - 调试前务必按
Ctrl+S（Windows/Linux）或Cmd+S（macOS）保存文件——VSCode 不会自动保存未保存的内容 - 如果用了
nodemon，它默认监听.js文件变化，但 launch.json 里不能直接填nodemon app.js，得配成runtimeExecutable+runtimeArgs
最容易被忽略的是：VSCode 终端是否真的继承了你 shell 里已生效的 npm 配置。比如你在系统终端能用 nodemon，但在 VSCode 里提示 command not found，大概率是终端没读取 ~/.zshrc，这时重启 VSCode 或手动执行 source ~/.zshrc 更直接。
