phpstorm 运行 react 应用报错90%源于 node.js 环境配置错误：① node.js interpreter 路径未正确设置（需填绝对路径，非软链或目录）；② javascript 语言版本未设为 react jsx；③ package.json 未被识别为项目入口（需确保在根目录并标记为 package.json）。

PhpStorm 运行 React 应用报错，90% 不是 React 本身的问题，而是 Node.js 环境没对上——解释器路径错、JSX 模式没开、或 npm 脚本根本没被识别。先确认这三点，再往下查。

Node.js interpreter 路径填错了，npm 命令直接标红

PhpStorm 启动时只读一次 node 可执行文件路径，不会随终端里 nvm use 动态更新。你终端里 node -v 是 v20.11.1，IDE 里可能还在用 v16.14.0，导致 npm run start 报错“command not found”或依赖解析失败。

• 在终端运行 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 文件本身，不是目录，也不是软链（如 ~/.nvm/versions/node/current/bin/node）
• 填完后右侧 Package manager 应自动填入同目录下的 npm；若没填，手动指定 npm 路径（如 /opt/homebrew/bin/npm）
• 点 OK 后，务必点右下角 Apply —— 只点 OK 不生效
• 改完重启 PhpStorm（不是重载项目），否则旧进程缓存还在

React JSX 语言模式没启用，.js 文件里写 <div> 直接标红 <p>PhpStorm 默认把 <code>.js 当纯 JavaScript 处理，不识别 JSX 语法。这不是插件问题，是语言上下文没切换。

Zenlink - Node SDK for ZenHeart

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

下载

• 右键项目根目录 → Open Module Settings → Languages & Frameworks → JavaScript
• 把 JavaScript language version 下拉菜单设为 React JSX
• 确认项目根目录下有 node_modules/react 且可读；若用 pnpm 或 yarn pnp，需在 Node.js and NPM 设置页手动指定 node_modules 路径
• 重启 PhpStorm 后打开任意 .js 文件，右下角状态栏应显示 React JSX 而非 JavaScript

package.json 里的 start 脚本在 IDE 里点不动、灰掉

PhpStorm 不会自动把任意 package.json 当项目入口。如果它没识别到，npm 工具窗口里脚本列表为空，右键 run 也是灰色。

• 确保 package.json 在项目根目录（即 File → Project Structure 里显示的 Project SDK 同级），不是子文件夹下
• 右键 package.json → Mark as Package.json，强制触发识别
• 若仍不显示脚本，在 package.json 里加个空格再保存，触发重解析；或彻底退出 PhpStorm 再启动（缓存有时卡住）
• 脚本名含破折号（如 dev:server）完全没问题，但别用中文或全角符号，PhpStorm 解析会失败

npm run start 启动了，但浏览器打不开 localhost:3000 或 HMR 不生效

开发服务器起来了，但页面白屏、刷新不热更，大概率是运行配置没配好自动打开，或 Webpack Dev Server 的端口/HMR 配置和 IDE 不同步。

• 在 Run → Edit Configurations 中找到 npm start 配置 → 切到 Browser / Live Edit 标签页
• 勾选 After launch → Open in browser，填 URL：http://localhost:3000（或你 package.json 里自定义的端口）
• 确认 start 脚本确实是 react-scripts start 或 vite；如果是 Vite 项目，检查 vite.config.ts 是否启用了 server.hmr
• HMR 失效常见于终端手动启动 vs IDE 启动环境不一致：删掉 node_modules/.vite 或 build 目录，再让 PhpStorm 重新跑一次 npm run start

最易被忽略的是：改了 package.json 或 node_modules 后，旧的 Run Configuration 不会自动更新。遇到脚本名变了、参数加了却没生效，直接删掉旧配置重建一个，比反复调试更省时间。