vscode运行html不依赖node，但live server等工具需node支持；因终端未继承path导致node不可用，须重装node并勾选“add topath”或手动配置环境变量，再重启vscode验证。
VSCode 运行 HTML 文件本身不依赖 Node 环境，但如果你要用 Live Server、http-server、自定义脚本或调试服务端逻辑（比如模板渲染、SSE、代理），就必须确保 VSCode 终端能正确调用 node 和 npm。关联失败不是 VSCode 配置错了，而是环境变量没被继承。
为什么终端里 node -v 有效，VSCode 里却报 command not found
VSCode 启动时默认用非登录 shell（如 PowerShell 或 zsh），不会自动加载你写在 ~/.zshrc、~/.bash_profile 或 Windows 用户变量里的 PATH。尤其常见于：
- Windows 安装 Node.js 时没勾选 “Add to PATH” —— 导致系统 PATH 根本没加
C:\Program Files\nodejs\ - macOS 使用 Homebrew 安装，但
~/.zshrc没导出 PATH，或 VSCode 是从 Dock 启动（跳过 shell 配置） - 用了 nvm/volta 切换 Node 版本，但 VSCode 终端没执行
nvm use或volta install node
验证方式：在 VSCode 内置终端（Ctrl+`）中直接运行 which node（macOS/Linux）或 where node（Windows）。无输出 = 未关联。
修复 Node 可执行性：三步到位
别跳过验证，所有后续配置（launch.json、Live Server、tasks.json）都依赖这一步。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 重装 Node.js，并**务必勾选 “Add to PATH”**（Windows MSI 安装器）
- macOS/Linux：检查
~/.zshrc是否有export PATH="/opt/homebrew/bin:$PATH"（Homebrew 路径）和export PATH="/usr/local/bin:$PATH"（Node 默认路径），然后运行source ~/.zshrc - Windows：打开“系统属性 → 高级 → 环境变量”，确认用户或系统 PATH 中包含
C:\Program Files\nodejs\（或你自定义的安装路径）
完成后重启 VSCode，再在终端跑 node -v 和 npm -v。两个都有输出，才算真正关联成功。
Live Server 和 http-server 为什么需要 Node
Live Server 插件底层调用的是 Node 的 http 模块，http-server 更是纯 Node CLI 工具。它们不是“VSCode 功能”，而是通过 VSCode 启动的外部进程 —— 所以必须能在终端里直接执行 node。
- Live Server 启动失败？先确认
node可用；若仍报错，检查插件设置里liveServer.settings.NodePath是否为空（一般不用填，除非你用了多版本管理） -
npx http-server报错 “command not found”？说明npx不可用，根源仍是node未就绪 - 用
tasks.json启动服务时，如果"type": "shell"下的命令含node app.js，一样会因找不到node而静默失败
launch.json 调试 HTML 相关服务时的坑
如果你写的是 Express 渲染 EJS/Pug、或 SSE 推送服务，launch.json 中的 program 必须指向绝对路径，且 runtimeExecutable 要明确指定 Node 可执行文件（尤其当系统有多个 Node 版本时）：
- 不要写
"program": "./app.js"—— VSCode 调试器不解析相对路径 - 推荐写
"program": "${workspaceFolder}/app.js"，并确保${workspaceFolder}存在且是项目根目录 - 若用 ESM（
import语法），必须加"runtimeArgs": ["--loader", "ts-node/esm"]或--experimental-specifier-resolution=node，否则http.createServer不会执行 - 监听地址别写
127.0.0.1—— 改成"0.0.0.0"，否则浏览器访问localhost:3000可能连不上
最易忽略的一点：VSCode 调试器默认不读取 .env 文件。如果服务依赖 NODE_ENV 或 PORT，得在 launch.json 的 env 字段里手动写死，比如 "env": {"NODE_ENV": "development", "PORT": "3001"}。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
