WebStorm 内置 Node.js 测试运行器自 2020.1 版本起支持 node:test（需 Node.js ≥18.13），但需满足四要素：正确配置的本地 Node.js 解释器、含 .test.js/.spec.js 扩展名的文件、显式 import { test } 调用、项目根目录存在 package.json，缺一则装订区无运行图标且报“Test framework not found”。
WebStorm 内置的 Node.js 测试运行器从 2020.1 版本起可用，无需额外安装框架即可运行 assert 或 node:test（Node.js 18.13+）编写的原生测试。但默认不启用，且容易因 Node.js 版本或配置缺失导致“Test framework not found”错误。
确认 Node.js 版本和内置运行器支持
内置测试运行器只在 Node.js 18.13 及以上版本中支持 node:test 模块；低于该版本只能跑 assert + 手动调用的简单脚本，不算“测试运行器”。检查方法：
- 终端执行
node -v，确保输出 ≥v18.13.0 - 在 WebStorm 中打开 Settings → Languages & Frameworks → Node.js and NPM，确认已配置正确的本地 Node.js 解释器（不是仅靠 PATH 自动检测）
- 若使用 WSL 或远程解释器，需确保该环境也满足版本要求，且
node:test未被禁用（如通过--no-fsevents等参数干扰）
创建符合 node:test 规范的测试文件
WebStorm 原生测试运行器只识别导出为 test 函数调用的文件（即 import { test } from 'node:test' 形式），不识别 assert.strictEqual() 单独调用或 console.assert()。
- 文件名必须含
.test.js或.spec.js（否则装订区不显示运行图标） - 必须显式导入并调用
test：例如test('should add numbers', () => { assert.strictEqual(1 + 1, 2); }); - 不能混用
describe/it—— 这是 Jest/Mocha 语法，内置运行器不解析 - 若用 ESM（
type: "module"），确保package.json已声明，否则报Cannot use import statement outside a module
在 WebStorm 中触发运行而非手动 node --test
右键菜单或装订区图标能直接启动内置运行器，但前提是 WebStorm 已将该文件识别为“可测试文件”。常见卡点：
- 首次打开项目后，需先执行一次
npm init -y或确保存在package.json（否则 WebStorm 不激活测试上下文） - 装订区图标不出现？检查文件是否在
test/或__tests__/目录下——虽然非必需，但 WebStorm 对这些路径有默认扫描偏好 - 点击图标后提示
Cannot find module 'node:test'？说明当前 Node.js 解释器路径指向旧版本（如 v16），需在 Run Configuration → Node.js interpreter 中重新选择 - 想批量运行整个目录？在 Project Tool Window 中右键文件夹 → Run 'Tests in …'，但仅限于含至少一个
.test.js文件的子目录
调试原生测试时注意异步断点失效
node:test 的钩子函数（如 beforeEach、test(...async () => {...})）在 WebStorm 调试器中可能跳过断点，尤其当测试用 await + setTimeout 模拟延迟时。
- 临时方案：在异步回调内加
debugger语句，再以 Debug 模式运行（非 Run） - 更稳做法：改用
test.only隔离单个测试，避免套件级生命周期干扰 - 注意
process.exitCode不会自动设为 1 —— 失败测试仍返回 0，需依赖 WebStorm 工具窗口中的红色失败计数判断结果，而非终端退出码
真正麻烦的不是写测试，而是让 WebStorm 把它当“测试”而不是普通 JS 文件来对待——路径、扩展名、Node 版本、package.json、解释器绑定，四者缺一不可。漏掉任意一个，图标就不出来，右键就无响应。
