已安装@playwright/test为开发依赖仍无法运行测试该如何解决

故障排查及解决方案 #

• 优先检查是否全局安装了旧版playwright包
  旧版全局playwrightCLI会优先被npx调用，且本身不包含测试依赖，会触发该报错。执行以下命令卸载全局版本：

  npm uninstall -g playwright
  

  卸载后优先使用项目内配置的脚本启动测试：

  npm run test
  

  如需直接调用，可强制npx使用本地安装的版本：

  npx --no-install playwright test --headed
  

• 修复损坏的本地依赖
  如果依赖安装过程出错也会触发该问题，执行以下命令重装依赖：

  rm -rf node_modules package-lock.json
  npm install
  

• 验证Node版本兼容性
  @playwright/test@1.16.1要求Node版本不低于12.0.0，执行以下命令查看当前Node版本：

  node -v
  

  如版本过低，升级到14.x及以上的LTS版本即可解决。
• 确认命令执行路径
  需确保你在package.json所在的项目根目录（即/c/Test目录）执行测试命令，不要进入test子目录执行命令。

验证方法 #

执行以下命令查看本地依赖安装状态，正常会输出安装的版本号：

npm ls @playwright/test

如果输出missing或unmet标识，说明依赖未正确安装，重新执行npm install即可。

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