vscode里node命令报“command not found”根本原因是环境变量未加载：windows用户安装时未勾选add to path，macos/linux因gui启动不加载~/.zshrc；需重装node.js或手动配置path并彻底重启vscode验证。

VSCode 里跑不了 node 命令？不是插件没装对，八成是环境变量根本没加载进来。

安装 Node.js 时必须勾选 Add to PATH

这是 Windows 用户最常漏掉的关键一步。不勾选，node 和 npm 就只在安装器内部可用，系统其他地方（包括 VSCode 终端）完全找不到。

• 重装是最稳妥的补救方式：卸载后重新运行 .msi 安装包，到“Custom Setup”页时，务必展开 “Node.js runtime”，勾选 Add to PATH
• 手动补救风险高：如果去系统环境变量里手动加 C:\Program Files\nodejs\，容易拼错路径或漏掉分号，还可能和旧版本冲突
• 验证是否生效：打开全新 CMD（不是已打开的旧窗口），执行 where node，应只返回一条路径；若返回多条，说明有残留旧版本

VSCode 启动后终端仍找不到 node？重启不够，得“重载”

VSCode 启动时会继承父进程的环境变量快照。如果 Node.js 是它启动之后才装的，集成终端永远看不到新 PATH —— 关闭再打开 VSCode 也不行，因为桌面快捷方式启动的 VSCode 还是继承了旧的 shell 环境。

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

• Windows：任务栏右键 VSCode 图标 → “退出”，然后双击图标重新启动（不要从旧终端用 code 命令启动）
• macOS/Linux：终端中执行 killall -u $USER code 清空所有 VSCode 进程，再从 Dock 或应用目录启动
• 终极验证法：在 VSCode 终端里运行 echo $PATH（macOS/Linux）或 echo %PATH%（Windows），确认输出里包含 Node.js 安装路径

code-runner 插件执行 JS 文件报错或乱码

这个插件默认用 node $fileName 执行，但不处理编码、模块解析或 stdin 输入，遇到中文路径、ES Module 语法或需要用户输入的脚本就会失败。

• 防乱码（仅 Windows）：设置里搜 code-runner.executorMap，把 javascript 对应值改成 "node -r utf-8 $fileName"
• 支持 import 语法：改成 "node --experimental-specifier-resolution=node $fileName"
• 交互式脚本（如含 process.stdin）必须绕过 code-runner，直接在终端里手动运行 node app.js

调试时断点不命中，提示“Cannot launch program because corresponding JavaScript cannot be found”

VSCode 的调试器（vscode-js-debug）依赖源码映射（source map）或原始文件路径匹配。一旦代码经过打包、转译（如 TypeScript）、或用了动态 import()，就容易找不到对应源文件。

• 纯 JS 项目：确保 launch.json 中 program 字段指向的是实际入口文件（如 "${file}" 或 "./index.js"），不是构建产物
• TypeScript 项目：必须配置 outFiles 并生成 source map，且 tsconfig.json 中 "sourceMap": true 和 "inlineSourceMap": false（推荐前者）
• 使用 nodemon 或其他进程管理工具时，调试器无法 attach 到子进程，需改用 attach 模式并监听特定端口

真正卡住人的从来不是 node -v 能不能跑出来，而是 VSCode 终端和调试器各自“看到”的环境不一致——这种差异藏在进程继承链和 shell 初始化逻辑里，手动修 PATH 往往治标不治本。