WebStorm编辑器内无法右键运行Jest测试且报错问题求助

1. 校准默认Jest全局配置 #

• 打开WebStorm偏好设置 → 构建、执行、部署 → 构建工具 → Jest
• 确认Jest package路径指向项目内node_modules/jest，不要使用WebStorm内置的Jest包
• 确认Node interpreter选择项目适配的arm64架构Node版本，不要使用Rosetta转译的x86版本
• 确认Working directory设置为项目根目录，和已验证可正常运行的全局Jest配置保持一致

2. 开启测试运行gutter图标 #

• 打开偏好设置 → 编辑器 → 内嵌提示 → 代码运行
• 勾选「JavaScript and TypeScript」分类下的「显示测试运行提示」选项
• 重启WebStorm查看测试文件侧边栏是否出现运行图标

3. 统一Jest运行模板参数 #

右键点击describe/it生成的临时运行配置未继承预设参数是语法报错的核心原因，按以下方式修复：

• 打开右上角运行/调试配置下拉框，选择「编辑配置」
• 点击「编辑配置模板」，选择Jest分类
• 将模板内的Node options、Jest options参数设置为和你正常运行的全局Jest配置完全一致，若项目依赖自定义Jest配置文件，需在Jest options中添加--config 你的配置文件路径（例如--config jest.config.js）
• 删除所有历史自动生成的单测试用例运行配置，重启WebStorm后再次尝试右键运行测试

4. M1芯片适配特殊排查 #

如果以上操作无效，手动指定Node路径避免识别异常：

• 打开终端执行which node，复制返回的Node执行文件绝对路径
• 回到WebStorm Jest配置页，手动将Node interpreter设置为刚才复制的路径，不要使用WebStorm自动检测的版本
• 点击顶部菜单栏「文件 → 清除缓存并重启」，等待索引重建完成后再次测试

内容的提问来源于stack exchange，提问作者Jonathan Tuzman