WebStorm不安装Node.js或npm，仅调用系统已安装的运行时；配置失败主因是系统级Node/npm未正确安装、PATH未包含其路径、或权限/缓存干扰识别；须先在命令行执行node -v和npm -v验证版本输出，再手动配置Settings→Languages & Frameworks→Node.js and NPM中的绝对路径。
WebStorm 本身不安装 Node.js 或 npm，它只识别、调用你系统里已装好的运行时和包管理器。配置失败的绝大多数情况，不是 WebStorm 没配对，而是系统层面的 Node/npm 没装好、路径没暴露、或权限/缓存干扰了识别。
确认系统级 Node 和 npm 已正确安装并可全局调用
这是所有后续配置的前提，跳过这步直接进 WebStorm 设置，大概率白忙活。
- 在任意命令行（CMD/PowerShell/Terminal）中执行
node -v和npm -v，必须能立刻输出版本号（如v20.12.1、10.5.0） - 如果报
'node' is not recognized，说明PATH环境变量没包含 Node 安装目录（例如C:\Program Files\nodejs\），需手动添加 - 不要依赖“安装时勾选 Add to PATH”——Windows MSI 安装器有时会失效；建议重装时取消勾选，再手动加
PATH，更可控 - 验证
npm config get prefix和npm config get cache，确保它们指向你预期的位置（比如D:\node\node_global），避免因权限问题写入%AppData%导致 WebStorm 找不到全局模块
WebStorm 中设置默认 Node.js 运行时
WebStorm 需要知道用哪个 node.exe 启动你的代码。它不关心你装了多少个 Node 版本，只认你指定的那一个可执行文件路径。
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
- 打开
Settings（Windows/Linux:Ctrl+Alt+S；macOS:Cmd+,）→Languages & Frameworks→JavaScript→Node.js - 在
Node interpreter字段旁点击...，选择你系统中真实的node.exe路径（不是安装目录，是具体可执行文件） - 如果你用了 nvm 或 fnm 管理多版本，这里必须选当前 shell 中
which node返回的那个路径，不能选 nvm 的 wrapper 脚本 - 选完后，下方
Package manager会自动识别出对应的npm（或yarn/pnpm），若识别失败，可手动点...指向你本地的npm.cmd或npm
为什么改了系统 PATH，WebStorm 还是找不到 npm 全局包？
因为 WebStorm 默认不加载全局 node_modules，即使 npm install -g eslint 成功，IDE 也不会自动补全或校验。这不是 bug，是设计使然——防止污染项目上下文。
- 进入
Settings→Languages & Frameworks→JavaScript→Libraries - 点击
Add...→Node.js Global，勾选此项，WebStorm 才会索引NODE_PATH或npm config get prefix下的node_modules - 注意：仅勾选
Node.js Global不够，你还得确保NODE_PATH环境变量已正确定义（如D:\node\node_global\node_modules），否则 IDE 仍找不到 - 如果项目用的是 pnpm/yarn，全局包路径逻辑不同，此时应优先用项目本地
node_modules，而非强求全局补全
运行/调试配置里 Node parameters 和 Application parameters 别混
这两个字段都出现在 Run/Debug Configurations → Node.js 里，但作用对象完全不同，填错会导致启动失败或参数被忽略。
-
Node parameters：传给node进程本身的选项，比如--inspect、--max-old-space-size=4096、--enable-source-maps -
Application parameters：等价于你在终端里写的node app.js arg1 arg2中的arg1 arg2，会被写入process.argv第 3 位起 - 常见错误：把
--port=4000塞进Node parameters，结果process.argv里根本收不到 —— 它应该放在Application parameters里 - 调试 Express 项目时，
bin/www是入口文件，Application parameters可留空；但若要传DEBUG=app*，得通过环境变量（Environment variables栏）而非参数栏
最常被忽略的一点：WebStorm 的 Node.js 配置是「项目级」的，但它的 Terminal（Alt+F12）默认用的是系统 Shell，不会自动继承你设的 Node interpreter。所以你在 Run 配置里选了 v20，Terminal 里 node -v 却显示 v18 —— 这不矛盾，只是上下文不同。需要统一行为，就得确保 Terminal 的 Shell 初始化脚本（如 .zshrc 或 PowerShell profile）也加载了正确的 Node 版本。
