PhpStorm配置Node.js环境需手动指定node可执行文件路径，而非依赖自动检测；若用nvm等版本管理工具，须选具体版本路径而非软链，且修改package.json后需删除旧Run Configuration以生效。
PhpStorm里Node.js运行环境配不起来？先确认这个路径
PhpStorm本身不自带Node.js，必须指向系统已安装的node可执行文件，否则所有后续操作都会报错。常见错误是点了“Auto-detect”却没反应，或者提示Cannot find Node.js——这基本说明它根本没找到二进制文件。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在终端运行
which node（macOS/Linux）或where node（Windows），复制完整路径，例如/usr/local/bin/node或C:\Program Files\nodejs\node.exe - PhpStorm → Preferences → Languages & Frameworks → Node.js and NPM → Node interpreter → 点右侧
...→ 粘贴路径，不要选目录，必须是node文件本身 - 如果用nvm或fnm管理多版本，别选全局软链（如
/usr/local/bin/node），而要选具体版本路径（如~/.nvm/versions/node/v18.18.2/bin/node），否则切换nvm版本后PhpStorm会失效
npm脚本在PhpStorm里点不运行？检查package.json是否被识别
PhpStorm不会自动把任意package.json当项目根，如果没正确识别，npm工具窗口里就看不到脚本列表，右键run也灰掉。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确保
package.json位于项目根目录（即File → Project Structure里显示的Project SDK同级），不是子文件夹下 - 右键点击
package.json→ “Mark as Package.json”，强制触发识别 - 若仍不显示脚本，在
package.json里加个空格再保存，触发重解析；或者重启PhpStorm（缓存有时卡住） - 脚本名含破折号（如
build:dev）完全没问题，但别用中文或全角符号，PhpStorm解析会失败
调试npm脚本时断点不命中？关键在Node.js启动参数
直接运行npm run dev默认不启用调试模式，就算PhpStorm里点了Debug按钮，也只是跑完就退出，VS Code那种自动注入--inspect的行为，PhpStorm不默认做。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在PhpStorm里右键脚本 → “Debug ‘xxx’”，它会自动生成一个Run Configuration，但默认没加调试参数
- 打开Run → Edit Configurations → 找到对应配置 → 在“Node parameters”栏手动填入
--inspect-brk（带-brk才能停在第一行） - 如果脚本本身已包含
node --inspect（比如"dev": "node --inspect server.js"），就别再重复加，否则报端口冲突 - Chrome DevTools调试需访问
chrome://inspect，但PhpStorm内置调试器更稳，优先用它，不用额外开浏览器
为什么改了npm script却没生效？注意Run Configuration的复用陷阱
PhpStorm每次右键运行脚本，会缓存一份Run Configuration。下次再点“Run”或“Debug”，它调用的是旧配置，不是实时读取package.json里的最新内容。改了脚本命令却不生效，八成是这个原因。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 修改
package.json后，进Run → Edit Configurations → 找到对应条目 → 点右上角“-”删掉它 - 下次再右键运行，PhpStorm会重建配置，读取最新脚本内容
- 如果多个脚本共用同一命令（比如都调
webpack），别手动复制配置，而是用“Templates → npm”统一设默认参数，避免分散维护 - 配置里“Working directory”默认是项目根，但如果脚本依赖子目录下的
node_modules（比如Lerna monorepo），得手动改成对应包路径，否则报Cannot find module
Node.js和npm在PhpStorm里不是“装好就通”，每个环节都卡在路径、缓存或参数上。最常被忽略的是：Run Configuration一旦生成就不会自动更新，哪怕package.json改了十次，它还按第一次的样子跑。
