如何使用npm运行指定的单个测试文件？

你遇到的问题核心原因通常是测试运行器参数传递不匹配或者package.json中test脚本配置有问题，按照以下步骤排查即可：

步骤1：确认package.json的test脚本配置 #

先查看项目根目录package.json的scripts字段：

{
  "scripts": {
    "test": "此处是实际执行的测试命令"
  }
}

如果你的test脚本写死了全量文件匹配规则（比如"test": "mocha tests/*.js"、"test": "jest tests/"），手动写的通配符会覆盖你后续传入的文件参数，导致始终跑全量测试，需要改成只保留测试运行器本身，比如"test": "jest"或者"test": "mocha"。

步骤2：按测试运行器类型使用正确命令 #

如果你用的是Jest/Vitest #

• 跑单个测试文件必须传完整相对路径，不能只写文件名：

  npm test -- tests/test_a.js
  

• --grep参数是匹配测试用例的标题（describe/it的第一个参数），不是文件名，你需要确认测试文件里的用例标题确实包含@test_a字符才能匹配到，例如：

  // test_a.js 里的用例要写对标记
  describe('@test_a 用户模块测试', () => {
    it('测试登录逻辑', () => {})
  })
  

如果你用的是Mocha #

• 跑单个文件同样要传完整路径：

  npm test -- tests/test_a.js
  

• grep匹配规则和Jest一致，仅匹配用例标题，不匹配文件名。

通用检查项 #

• 必须保留命令中的--分隔符：npm规定--后面的参数才会透传给实际执行的测试运行器，少了这个分隔符参数会被npm本身拦截，不会生效。
• 不要省略路径前缀tests/，测试运行器默认从项目根目录开始匹配文件，只写文件名会匹配不到对应文件， fallback到全量执行。

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