Vitest命令行Flags失效求助：无法在npm run test中使用--coverage等参数

核心问题：npm脚本参数传递规则 #

npm运行自定义脚本时，必须在脚本名后加--才能将后续参数传递给目标命令。如果直接写npm run test --coverage，参数会被npm本身接收，而非传递给Vitest。正确写法：

npm run test -- --coverage

npm run test -- --silent

检查package.json的test脚本配置 #

确保你的package.json里的test脚本是直接调用vitest，不要包裹额外冗余逻辑：

{
  "scripts": {
    "test": "vitest"
  }
}

如果脚本里有额外前缀（如ts-node或其他包装命令），会导致参数无法正确透传给Vitest。

IDEA运行配置调整 #

如果是在IDEA中执行测试，需要手动配置参数传递：

• 打开Run/Debug Configurations面板
• 找到对应的npm test配置项
• 在「Arguments」栏中，把参数写在--之后，示例：test -- --coverage
• 保存配置后重新运行测试

本地环境排查 #

• 核对npm版本：不同版本对参数传递的处理存在差异，执行npm -v，建议升级到v8及以上稳定版本
• 清理缓存并重装依赖：执行npm cache clean --force，再运行npm install
• 对齐Vitest版本：执行npm list vitest，确保本地版本和队友一致，版本差异可能引发参数兼容性问题

内容的提问来源于stack exchange，提问作者Gabriele Cinà