Node.js interpreter路径填错导致脚本无法启动，需手动指定完整可执行文件路径（如/opt/homebrew/bin/node或C:\Users\Alice\AppData\Roaming\nvm\v20.11.1\node.exe），禁用Auto-detect，粘贴路径后务必点击Apply，并重启IDE生效。

Node.js interpreter 路径填错，脚本根本没启动

你点了 Run，控制台一片空白，或者只显示 Process finished with exit code 0 却没任何输出——大概率是 PhpStorm 根本没调用到真正的 node。它可能在用一个空路径、软链、甚至系统里早已卸载的旧版本。

• 终端执行 which node（macOS/Linux）或 where node（Windows），复制**完整可执行文件路径**，例如 /opt/homebrew/bin/node 或 C:\Users\Alice\AppData\Roaming\nvm\v20.11.1\node.exe
• 进 Settings → Languages & Frameworks → Node.js and NPM → Node interpreter，点右侧 …，**粘贴路径，不是目录，必须是带 node 文件名的路径**
• 别信 Auto-detect：它只查初始 PATH，不读 shell 配置，对 nvm/fnm 用户基本无效
• 填完后，**务必点右下角 Apply**；只点 OK 不生效，这是最常被跳过的一步

Run Configuration 类型选错，断点不触发、import 报错

写了 import fs from 'fs'，却用 CommonJS 模式跑，结果报 Cannot use import statement outside a module；或者打了断点，调试时直接跳过——不是代码问题，是运行配置和代码类型没对齐。

• 纯 JavaScript + "type": "module" 在 package.json 中？→ Run Configuration 类型选 Node.js，JavaScript file 必须指向 .mjs 文件，或加参数 --loader ts-node/esm（若用 ts-node）
• TypeScript 项目？→ **别直接选 Node.js 类型并填 src/index.ts**；改用 npm 类型，Scripts 填 dev 或 start，复用 tsconfig.json 和构建逻辑
• 硬要用 Node.js 类型跑 TS？→ 确保已装 ts-node 和 @types/node，并在 Node parameters 填 -r ts-node/register（CommonJS）或 --loader ts-node/esm（ESM）

插件没开或 Core 库没加载，补全失效、fs 标红

fs.readFile 下划红线、没参数提示、require('path') 提示无法解析——这不是 Node.js 没装好，是 PhpStorm 没把内置模块当“自己人”。

Zenlink - Node SDK for ZenHeart

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

下载

• 检查 Settings → Plugins，确认这三个插件已启用：JavaScript and TypeScript、Node.js、JavaScript Debugger（它们默认捆绑，但可能被手动禁用）
• 进 Settings → Languages & Frameworks → JavaScript → Libraries，点 Download，搜 Node.js Core 并安装
• 同时勾选 Settings → Languages & Frameworks → JavaScript → Runtime 页面里的 Enable Node.js Core library
• node_modules 没自动识别？右键项目根目录 → Reload project，或确认 package.json 存在且依赖已通过 npm install 安装

用了 nvm 却始终切不到对的版本

终端里 node -v 是 v20.11.1，PhpStorm 里还是 v16.14.0，导致 fetch() 报错、globalThis 未定义、甚至 npm install 在 IDE 内失败——因为 PhpStorm 启动时只读一次路径，不响应 nvm use 动态切换。

立即学习“PHP免费学习笔记（深入）”；

• 路径必须指向具体版本，例如 ~/.nvm/versions/node/v20.11.1/bin/node，**绝不能用 ~/.nvm/versions/node/current/bin/node**（软链易被 nvm 更新破坏）
• 检查项目根目录是否有 .nvmrc；若有，确保内容（如 20.11.1）和 PhpStorm 配的路径一致，否则删掉它
• 改完配置后，**必须彻底退出 PhpStorm 再重启**，不是重载项目——旧进程缓存的环境变量还在

真正卡住人的从来不是“会不会配”，而是路径没指对、Apply 没点、插件没开、nvm 版本没锁死——这四件事漏一个，整个 Node.js 环境就处于“看似正常、实则瘫痪”的状态。