WebStorm 运行 Mocha 测试需满足三个前提：Node.js 已安装并被识别、Mocha 本地安装（推荐 --save-dev）、测试文件不被当作普通 JS 执行；否则会报 describe is not defined 等错误。
WebStorm 能直接运行 Mocha 测试，但必须满足三个硬性前提：Node.js 已安装且被 WebStorm 识别、Mocha 包已正确安装（推荐 --save-dev）、测试文件未被误当成普通 JS 执行。缺一不可，否则你会看到 describe is not defined 或 ReferenceError: it is not defined 这类错误。
为什么直接用 node 运行 test.js 会报 describe is not defined
因为 describe 和 it 是 Mocha 提供的全局函数，不是 Node.js 原生 API。直接执行 node test.js 时，Node.js 完全不知道 Mocha 的存在，自然找不到这些函数。
- ✅ 正确做法：让 Mocha CLI 加载并执行你的测试文件，例如
npx mocha test/*.js或通过 WebStorm 的 Mocha 运行配置 - ❌ 错误做法：右键 test.js → “Run ‘test.js’”，这等价于
node test.js，必然失败 - ⚠️ 注意：即使你全局安装了 Mocha（
npm install -g mocha），WebStorm 默认也不会自动使用它——必须在运行配置中显式指定Mocha package路径或选中“Project alias”
如何创建有效的 Mocha 运行/调试配置
关键不是“点+号选 Mocha”，而是填对四个字段：Node 解释器、Mocha package、Working directory、Test directory（或 Test file）。
-
Node interpreter：必须指向一个有效的 Node.js 可执行路径（如/usr/local/bin/node或 Windows 下的C:\Program Files\nodejs\node.exe）。不能留空，也不能选错版本（低于 v14 会出兼容问题） -
Mocha package：优先填项目本地路径，例如node_modules/mocha；若 WebStorm 没自动识别，就手动点击浏览按钮定位到node_modules/mocha/bin/_mocha（注意不是mocha.js） -
Working directory：设为项目根目录（即含package.json的目录），否则require相对路径或NODE_PATH可能失效 -
Test directory：填test或src/test等实际存放*.spec.js或*.test.js的目录；如只跑单个文件，改用Test file并指定完整路径
调试时断点不生效？检查这两个隐藏开关
断点灰色、无法停住，大概率不是代码问题，而是配置漏项或环境冲突。
- 确保
Node options字段里没误填--inspect或--inspect-brk—— WebStorm 调试模式会自动注入，手动加会导致端口冲突或启动失败 - 检查
Environment variables是否意外设置了NODE_OPTIONS=--enable-source-maps之类；Mocha 本身不依赖此变量，反而可能干扰调试器解析源码映射 - 如果用了 TypeScript，确认
ts-node已安装且Extra Mocha options中包含--require ts-node/register，否则断点会落在编译后的 JS 上，而非 TS 源码
测试图标不显示、装订区空白？重点查插件和文件命名
编辑器左侧 gutter 没出现 ▶ 或 ? 图标，说明 WebStorm 根本没把该文件识别为 Mocha 测试。
- 确认
Node.js插件已启用：Settings → Plugins → 搜索 “Node.js”，勾选并重启 - 确认测试文件名匹配默认模式：WebStorm 默认只扫描
*.test.js、*.spec.js、test/*.js；如果你用__tests__/xxx.js或.mjs后缀，需在 Settings → Tools → Testing → Mocha 中修改Test file pattern - 确认文件内有合法的 Mocha 结构：至少有一层
describe()包裹it()，且没有语法错误（比如describe写成describle）
最常被忽略的一点：WebStorm 的 Mocha 支持依赖于项目中真实存在的 node_modules/mocha。哪怕你全局装了 Mocha，只要项目里没 package.json 或没运行过 npm install，WebStorm 就不会激活测试识别逻辑——它不猜，只认路径。
