webstorm 能直接运行 mocha 测试，但需确保 node.js 插件启用、node.js 解释器正确配置、本地安装 mocha（--save-dev）、测试文件命名符合 .test.js 或 .spec.js 规范，且运行配置中 mocha package 指向 node_modules/mocha。
WebStorm 能直接运行 Mocha 测试，但默认不自动识别 describe、it 等全局函数 —— 你看到“describe is not defined”或测试图标不亮，基本就是配置没到位。
确认 Node.js 插件已启用且 Node.js 解释器已配置
这是所有后续操作的前提。WebStorm 不是靠“装了 Node.js”就自动工作，它得明确知道用哪个 node 可执行文件。
- 进
Settings（Windows/Linux）或Preferences（macOS），路径：Languages & Frameworks → Node.js and npm - 检查
Node interpreter字段是否指向有效的node路径（比如/usr/local/bin/node或C:\Program Files\nodejs\node.exe）；若为空，点击右侧...手动选择 - 返回
Plugins页面，搜索Node.js，确保勾选并已启用（2020.3+ 版本默认内置，但可能被手动禁用） - 如果
Node.js插件未启用，describe和it在编辑器里会标红，且 gutter 区不会出现运行图标
安装 Mocha 并正确声明为开发依赖
WebStorm 的 Mocha 运行器依赖项目本地的 mocha 包，不是全局安装的版本 —— 即使你 npm install -g mocha 成功，WebStorm 也大概率找不到它。
- 在项目根目录打开 WebStorm 内置终端（
Alt+F12），执行：npm install --save-dev mocha - 验证是否成功：
ls node_modules/mocha（Linux/macOS）或dir node_modules\mocha（Windows）应存在 - 不推荐只用
npm install mocha（无--save-dev），因为 WebStorm 的运行配置默认读取devDependencies列表来定位包路径 - 如果用 TypeScript，还需加装
chai或@types/mocha，否则类型提示和语法校验会报错
创建 Mocha 运行配置时的关键字段填什么
直接点 gutter 里的 ▶ 图标能跑单个测试，但想批量运行、递归扫描、传参数，必须配好运行配置。
- 打开
Run → Edit Configurations，点击+→ 选Mocha -
Mocha package：必须指向你项目里的node_modules/mocha，例如./node_modules/mocha；WebStorm 有时自动填成全局路径，要手动改掉 -
Test directory：填测试文件所在目录，如test或src/test；别填test/*.spec.js这种 glob，它不支持 -
Extra Mocha options：常用--recursive（让 Mocha 进子目录找测试）、--timeout 10000（避免异步测试误超时） -
Working directory：保持默认（项目根目录），除非你的package.json或配置文件不在根目录
为什么 gutter 没有运行图标？常见断点失效原因
即使配置全对，图标不出现或点了没反应，往往卡在命名或环境细节上。
- 测试文件名必须匹配 WebStorm 默认识别模式：
*.test.js、*.spec.js、test-*.js；index.js或main.js里的测试代码不会被识别 - 检查
Settings → Editor → Inspections → JavaScript → General → Undefined symbols是否被禁用 —— 如果禁用了，describe就不会被当作合法全局变量处理 - 如果用了 ES modules（
import/export），Mocha 默认不支持，需额外配--require @babel/register或改用mocha --loader ts-node/esm（TypeScript 场景） - 调试时断点不命中？确认你点的是
Debug按钮，不是Run；且 Node.js 版本 ≥ 14（低版本对 V8 inspector 支持不稳）
最易被忽略的一点：WebStorm 的 Mocha 运行器不会自动加载 mocha.opts 文件，所有选项必须显式写进运行配置的 Extra Mocha options 栏里，否则 --require、--ui 等都无效。
