在 Jest 中运行单个测试文件最直接的方式是传入文件路径,如 jest __tests__/math.test.js;支持相对/绝对路径及 glob 模式,推荐加引号避免 shell 解析错误。

在 Jest 中运行单个测试文件,最直接的方式是把文件路径作为参数传给 jest 命令。
使用文件路径运行单个测试文件
假设你的测试文件叫 math.test.js,位于项目根目录下的 __tests__ 文件夹中,可以在终端中执行:
jest __tests__/math.test.js
Jest 会自动匹配并只运行这个文件里的所有测试用例(test 或 it 块)。
- 路径支持相对路径、绝对路径,也支持 glob 模式(如
jest "src/**/user*.test.js") - 如果文件名不带
.test.或.spec.后缀,需确保它被testMatch配置覆盖,或显式加上--testPathPattern - 推荐使用引号包裹路径,避免 shell 对特殊字符(如
*、空格)误解析
通过匹配文件名快速运行
如果你不想写完整路径,可以用 --testNamePattern 或 --testPathPattern 精确筛选:
jest --testPathPattern=math.test.js
这个命令会在整个项目中查找文件路径包含 math.test.js 的测试文件,适合不确定具体位置时快速定位。
-
--testPathPattern匹配的是文件路径字符串(正则),不是测试名称 -
--testNamePattern匹配的是test()第一个参数中的描述文本(例如test('adds 1 + 2 to equal 3', ...)) - 两者可同时使用,进一步缩小范围
配合 watch 模式只监听单个文件
开发过程中常希望边改边测,可以加 --watch 并指定文件:
jest --watch __tests__/math.test.js
这样 Jest 启动 watch 模式后,只监控该文件变化,保存即重新运行,不触发其他测试,响应更快。
- watch 模式下也可按
p进入路径搜索,输入文件名快速过滤 - 按
t可输入测试名关键词,筛选某个test块单独运行(适合调试单个用例)
注意事项
确保 Jest 已正确安装(本地优先):
- 推荐使用
npx jest ...或npm test -- ...(注意双横线分隔参数) - 若项目有自定义配置(
jest.config.js),路径匹配逻辑可能受testMatch、roots影响,建议先确认配置是否覆盖目标文件 - Windows 用户注意路径分隔符兼容性,用正斜杠
/通常更稳妥
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











