如何在VSCode中配置Node并运行JS文件 - 新手入门安装手册-VSCode-PHP中文网

vscode本身不提供node.js运行时，必须先安装系统级node.js并确保path正确配置；node -v在系统终端成功但在vscode中报错，根本原因是vscode未继承更新后的path，需重启vscode或通过终端启动code .解决。

如何在vscode中配置node并运行js文件 - 新手入门安装手册

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 二进制文件本身。

Zenlink - Node SDK for ZenHeart

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

常见错误现象：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 更直接。