vscode不自带node.js，需系统安装并确保path正确：linux推荐用nvm安装lts版，从终端执行code .启动vscode以继承shell环境，验证需在内置终端运行node -v和which node。
VSCode 本身不安装 Node.js，它只用系统已有的 node 可执行文件。你在 Linux 上要做的，是让系统装好 Node.js（最好是 LTS 版），再确保 VSCode 能找到它。
为什么不能直接在 VSCode 扩展里“装 Node.js”
VSCode 的 “Node.js” 扩展（比如名字叫 Node.js 或 Node Debug 的）只是提供语法提示、调试支持或 npm 集成，不是运行时。它不包含 node 二进制文件。如果你只装了这类扩展，终端里输 node -v 仍会报 command not found。
常见错误现象：
- VSCode 内置终端运行
node app.js失败，提示bash: node: command not found - 调试时弹出 “Cannot find runtime 'node' on PATH” 错误
- 点击左下角状态栏的 Node 版本号，发现列表为空
推荐方式：用 nvm 安装并管理 Node.js LTS
nvm（Node Version Manager）是 Linux 下最稳妥的方式，能避免权限问题、多版本共存、且无需 sudo 安装全局模块。
操作步骤：
Browser Setup (No-Root Linux)
下载
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
- 在终端运行：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash（注意：nvm 最新版号请查 GitHub 主页） - 关闭并重开终端，或执行：
source ~/.bashrc（若用 zsh，则改用~/.zshrc） - 验证 nvm 是否生效：
nvm --version应输出版本号 - 安装当前 LTS 版本：
nvm install --lts（会自动选如v20.15.1这类稳定版） - 设为默认：
nvm alias default lts/* - 检查是否可用：
node -v和npm -v都应返回版本号
参数差异提醒：nvm install --lts 比 nvm install stable 更可靠——前者明确拉取官方标记为 LTS 的版本，后者可能指向非 LTS 的最新稳定版（如 v21.x），而很多生产项目仍依赖 v18 或 v20 LTS。
VSCode 怎么识别到这个 node
只要 node 命令在 shell 的 PATH 中，VSCode（尤其是从终端启动时）就能自动继承该环境。
关键点：
- 不要用
sudo apt install nodejs—— Ubuntu/Debian 自带的包通常版本老旧（如 v18.19.0），且命令名可能是nodejs而非node，容易引发兼容性问题 - 务必从终端启动 VSCode：
code .，而不是桌面图标双击。否则 VSCode 可能读不到你~/.bashrc里加载的 nvm 环境 - 如果已用图标打开，可按
Ctrl+Shift+P→ 输入Developer: Restart Language Server，或干脆关掉 VSCode，用终端重开 - 验证方法：在 VSCode 内置终端（
Ctrl+`）中执行which node，路径应类似~/.nvm/versions/node/v20.15.1/bin/node
遇到 “找不到 node” 时先查这三处
这是最常卡住的地方，顺序排查比重装快得多：
-
echo $PATH是否包含 nvm 的 bin 目录？没有就说明source ~/.bashrc没生效，或你用的是 zsh 但没改~/.zshrc -
nvm current是否返回有效版本？若显示N/A，说明当前 shell 未激活任何 node 版本，运行nvm use --lts试试 - VSCode 设置里搜
terminal.integrated.defaultProfile，确认终端类型匹配你的 shell（比如 Ubuntu 默认是 bash，但你改用了 zsh，就得手动指定）
nvm 的 shell 初始化逻辑很细，不同发行版、不同 shell 的配置位置和加载时机稍有差异；一旦 PATH 没对上，VSCode 就彻底“看不见” node —— 这个环节最容易被忽略，也最难凭直觉发现。
