Atom 本身没有内置测试运行器,所以想在编辑器里跑单元测试,得靠第三方框架加上插件来搭桥。你按 cmd+shift+t 或 ctrl+shift+t 时,能跑起来其实是底层调用了项目里已经配好的测试命令(比如 a va、jest),跟 Atom 自己的“执行测试”功能没半毛钱关系。下面聊三种常见方案,各有各的脾气。
用 atom-a va 插件跑 A VA 测试
这套组合最轻量,也最贴近 Atom 原生体验,适合小项目或者快速验证逻辑。要注意几个坑:
- 项目根目录必须提前装好
a va并初始化配置(npx a va --init),否则插件直接静默失败,连个报错都没有。 - 插件只认文件名含
.test.js、.spec.js或.test.ts的文件,其他后缀一概不认。 - 快捷键
cmd+shift+t(Mac)或ctrl+shift+t(Win/Linux)只对当前打开的测试文件或它所在目录生效;如果你光标停在一个普通.js文件上,它不会自动去找同名的.test.js。 - 错误堆栈默认不带源码映射——要是用了 Babel 或 TypeScript,记得在
package.json的a va字段里显式把sourceMaps设为true,不然调试时定位到编译后的代码,哭都来不及。
用 Nuclide 开发模式跑 Jest 测试
Nuclide 是 Facebook 曾经维护的 Atom 插件套件,虽然已经停更了,但它的 Jest 集成依然是目前 Atom 中对大型前端项目支持最完整的方案,尤其适合 React、Flow 或者 Lerna 多包项目。不过门槛也高:
- 测试文件必须放在
__tests__/modules/nuclide-commons/__tests__/someModule-test.js),顶层src/下的*.test.js根本不会被识别。 - 依赖
jest.config.js存在且导出有效配置;如果项目用了ts-jest,还得确保jest.setup.js正确加载了 TypeScript 编译环境。 - 启动前必须执行
apm link --dev+atom --dev,否则 Nuclide 的测试面板根本不会加载——这一步经常被忽略。 - 测试运行时的
cwd是 Atom 当前打开的最外层项目根目录,不是单个文件所在目录。这点和atom-a va完全不同,容易因为路径错位导致模块解析失败,排查起来很头疼。
自定义 build 配置跑任意测试命令
当上面两种方案都不适用(比如你要跑 Cypress、Vitest 或者自定义的 mocha 脚本),atom-build 是更可控的选择。但自由度大也意味着配置细节多:
- 在项目根目录建
atom-build.yml,内容不能只写cmd: npm test,必须指定sh: true,否则 Windows 下会报'npm' is not recognized。 - 如果测试命令依赖本地
node_modules/.bin,cwd必须设为项目根(cwd: "."),否则找不到二进制文件。 - 错误匹配正则要手动配,比如捕获 Jest 报错行:
errorMatch: ['^.*at (.*):([0-9]+):([0-9]+)$'],不然失败时只显示“构建失败”,看不到具体哪行错了。 - 支持多目标,比如同时定义
test:unit和test:integration,通过 Atom 状态栏右下角菜单切换,挺方便的。
最后说一个容易被忽略的点:Atom 所有测试插件都不接管进程生命周期。测试卡死、内存溢出、未关闭的定时器,都会让后续运行持续变慢甚至阻塞 UI。建议在 beforeEach 里加 jest.resetModules()(Jest)或 test.beforeEach(() => { /* 清理全局状态 */ })(A VA),别指望插件自动帮你兜底。