webstorm内置mocha运行器不支持mochawesome等第三方reporter，必须通过npx mocha命令行方式生成html报告；配置extra mocha options为--reporter mochawesome并指定reportdir，确保工作目录正确，避免缓存导致报告不更新。
WebStorm里Mocha测试报告默认不生成HTML
WebStorm自带的Mocha运行器只显示控制台文本输出，mochawesome、html 或 json 报告不会自动出现——你点运行图标看到的只是树状结构+日志，不是网页。想出可视化报告，必须绕过WebStorm内置Reporter，改用命令行驱动模式。
用npx mocha + mochawesome生成HTML报告
WebStorm本身不支持直接配置mochawesome Reporter路径，但你可以把它当“终端快捷入口”来用。关键不是改运行配置里的Reporter字段，而是把整个命令塞进Extra Mocha options：
- 先安装：
npm install --save-dev mochawesome - 在Mocha运行配置中，清空
Reporter下拉框（留空），避免和mochawesome冲突 -
Extra Mocha options填：--reporter mochawesome --reporter-options "reportDir=reports,reportFilename=report,inlineAssets=true" - 确保
Working directory是项目根目录（含package.json），否则node_modules/mochawesome可能找不到
运行后，会在项目下生成reports/report.html，直接双击打开即可。
为什么WebStorm的“Project alias”或全局mocha路径配了也不生效
因为WebStorm的Mocha运行器硬编码使用了它自己的mochaIntellijReporter.js，哪怕你手动指定--reporter mochawesome，它仍会优先加载内部Reporter。这不是bug，是设计限制。
- 现象：控制台报错
Error: Cannot find module 'mochawesome'，或报告目录为空 - 原因：WebStorm启动时用的是
node_modules/mocha/bin/_mocha，但它的require.resolve('mochawesome')上下文受限，找不到你本地装的包 - 解法：别依赖WebStorm图形界面选Reporter，老实用
npx mocha命令跑，在WebStorm终端里执行npx mocha test/**/*.spec.js --reporter mochawesome更可靠
调试时HTML报告不更新？检查缓存和路径
生成的report.html常被浏览器缓存，尤其Chrome对file://协议缓存激进；同时reportDir若设成相对路径如./reports，不同工作目录下可能写到奇怪位置。
- 每次生成前加
--clean参数：--reporter-options "clean=true,reportDir=reports" - 浏览器中右键“重新加载”不够，要用
Ctrl+Shift+R强制刷新，或改用Live Server插件托管reports/目录 - 绝对路径更稳：
--reporter-options "reportDir=/full/path/to/your/project/reports"
真正麻烦的从来不是生成报告，而是让WebStorm“放手”，让它只管启动进程，把Reporter控制权交还给Mocha CLI本身。
