PhpStorm 中 Node.js 配置失败主因是路径错误、插件未启用或配置未 Apply；需手动指定完整 Node 路径、匹配 Run Configuration 类型、安装 Node.js Core 库、启用相关插件并重启 IDE。
PhpStorm 里 Node.js 配不成功，90% 是因为路径没指对、插件没开、或配置没 Apply —— 不是它不识别，是你没给它对的线索。
Node.js 解释器路径填错：别信自动检测
PhpStorm 启动时只读一次 Node.js 路径，不会随终端里 nvm use 动态更新。你终端里 node -v 显示 v20.11.1，IDE 里可能还在用 v16.14.0，直接导致 import 报错、require() 找不到模块、甚至 npm install 在 IDE 内失败。
- 手动指定完整路径，而不是软链：
~/.nvm/versions/node/v20.11.1/bin/node（macOS），不是~/.nvm/versions/node/current/bin/node - Windows 用户注意：
C:\Program Files\nodejs\node.exe是默认路径；若用nvm-windows，得选类似C:\Users\XXX\AppData\Roaming\nvm\v20.11.1\node.exe - 填完务必点右下角
Apply，只点OK不生效 - 检查项目根目录有没有
.nvmrc；如果有，确保 PhpStorm 里配的版本和它一致，否则删掉它
Run Configuration 类型和入口文件不匹配：断点不命中
你打了断点，调试时却直接跑过——大概率是运行模式和代码类型对不上。ES Module（含 import）用 CommonJS 模式启动，或者 TypeScript 项目直接指向 src/index.ts，IDE 就会跳过源码映射。
- 如果是纯 JavaScript 项目，Run Configuration 类型选
Node.js，JavaScript file字段必须填编译后的真实入口，比如dist/index.js - 如果是 TypeScript 项目，推荐类型选
npm，脚本名填dev或start（对应package.json中的"scripts"），这样能复用tsconfig.json和构建逻辑 - 如果硬要用
Node.js类型跑 TS，必须加--loader ts-node/esm参数，并确认已装ts-node和@types/node
插件没启用或核心库没加载：补全失效、fs/path 红线
即使 Node.js 解释器配对了，fs.readFile 还是标红、没有参数提示——说明 PhpStorm 没把 Node.js Core 模块当“自己人”。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Languages & Frameworks → JavaScript → Libraries，点Download，搜Node.js Core并安装 - 同时勾选（在
Settings → Languages & Frameworks → JavaScript → Runtime页面） - 确认
JavaScript and TypeScript、Node.js、JavaScript Debugger这三个插件已在Settings → Plugins里启用（它们默认捆绑，但偶尔会被手动禁用） -
node_modules库需自动识别：只要package.json存在且依赖已安装，PhpStorm 会自动把node_modules加入库路径；若没反应，右键项目根目录 →Reload project
最常被忽略的是重启：改完配置后，必须彻底退出 PhpStorm 再启动，否则旧进程缓存的环境变量还在，所有改动都白配。
