WebStorm 正确识别 Node.js 解释器需手动配置绝对路径：macOS 填 /opt/homebrew/bin/node（Apple Silicon）或 /usr/local/bin/node（Intel），Windows 填 C:\Program Files\nodejs\node.exe，Linux 填 /usr/bin/node 或 nvm 路径下的 bin/node；路径必须指向可执行文件本身，非目录或别名，且需重启 IDE 生效。
检查 Node.js 解释器是否被 WebStorm 正确识别
WebStorm 无法运行或调试 Node.js 项目，90% 的情况源于解释器未配置或指向错误路径。它不会自动继承系统 PATH 中的 node，必须显式指定可执行文件位置。
操作步骤：
- 打开
File > Settings > Languages & Frameworks > Node.js and NPM - 查看
Node interpreter字段：若显示Not configured或路径为/usr/local/bin/node（macOS）但实际安装在/opt/homebrew/bin/node（Apple Silicon），说明不匹配 - 点击右侧
...→ 手动定位到你通过官网安装的 Node.js 可执行文件（Windows 是node.exe，macOS/Linux 是node文件本身，不是 symlink 目录） - 确认后，下方
Package manager应自动识别出对应版本的npm；若仍显示Not found，说明 npm 未随 Node.js 正常安装，需重装 Node.js（LTS 版本）
验证 Vue/React 等框架支持插件是否启用
刚克隆的 Vue 项目里 .vue 文件报红、<script setup></script> 无语法高亮、组件属性没提示——大概率是 Vue.js 插件没开，而非 ESLint 配置问题。
关键点：
- 进入
Settings > Plugins，搜索Vue.js，确保状态为Enabled（不是灰色的Installed） - 对 React 项目，需额外启用
JavaScript and TypeScript（默认开启）和React Support插件 - 插件启用后，重启 WebStorm —— 不重启，
.vue文件仍会被识别为纯 HTML，导致 script 块内 ES6+ 语法报错 - 若使用 Vite + Vue 3，还需确认
Settings > Languages & Frameworks > JavaScript > Libraries中已加载node_modules/vue类型定义（自动触发，但首次打开项目可能延迟）
确认 ESLint 和 Prettier 是否与项目配置对齐
代码能跑，但满屏红色波浪线，且 Alt+Shift+F 格式化后代码更乱——这是 WebStorm 默认格式化规则和项目 .eslintrc.js / .prettierrc 冲突的典型症状。
必须同步三处：
- ESLint：进
Settings > Languages & Frameworks > JavaScript > Code Quality Tools > ESLint，勾选Enable，并设Configuration file为项目根目录下的.eslintrc.js（不是全局配置） - Prettier：进
Settings > Languages & Frameworks > JavaScript > Code Quality Tools > Prettier，启用并指定Prettier package为node_modules/prettier（本地安装优先），同时勾选Run on save - 关键开关：关闭 WebStorm 自带的
Code Style > JavaScript > Prettier以外的所有格式化选项（如Spaces、Wrapping and Braces），否则会和 Prettier 叠加执行，产生不可预测缩进
检查 tsconfig.json 路径别名是否被 WebStorm 解析
导入语句如 import { Button } from 'tdesign-vue-next' 报错“Cannot find module”，但 tsc 编译正常——说明 TypeScript 编译器认得 paths，而 WebStorm 没加载。
解决方法很直接：
- 打开项目根目录
tsconfig.json，确认"compilerOptions": { "baseUrl": "./", "paths": { ... } }存在且语法正确 - 在 WebStorm 中，右键项目根目录 →
Reload project from disk（不是刷新文件树） - 若仍无效，在
Settings > Languages & Frameworks > TypeScript中，确保Use TypeScript Service已启用，且Compiler version指向node_modules/typescript（非 IDE 内置版本） - 特别注意：
paths映射目标路径必须是相对baseUrl的有效路径，WebStorm 不支持通配符展开（如"*": ["src/*"]在某些版本下失效）
真正容易被忽略的是：WebStorm 对 tsconfig.json 的读取是惰性的，改完配置不重启或不手动重载，它就继续用旧缓存。很多“配置明明写了却没用”的问题，卡在这一步。
