如何在WebStorm中配置wdio测试运行器调试单个测试用例？

我之前搭建Mocha + WebdriverIO测试框架时，也碰到过一模一样的问题——CLI跑测试完全正常，但WebStorm没法直接调试单个用例。确实目前WebStorm没有原生支持WDIO的单例调试，但通过自定义Node.js运行配置就能搞定，具体步骤如下：

1. 创建新的Node.js运行配置 #

• 点击WebStorm右上角的运行配置下拉菜单，选择「Edit Configurations...」
• 在弹出的窗口左上角点击「+」号，选择「Node.js」类型的配置

2. 配置核心参数 #

在配置面板里填写以下关键项：

• JavaScript file：指定WDIO CLI的入口文件，一般是项目依赖里的node_modules/@wdio/cli/bin/wdio.js（如果是WDIO v6及更早版本，路径可能是node_modules/wdio/bin/wdio.js，根据你的实际版本调整）
• Working directory：设置为你的项目根目录（确保WDIO能找到配置文件和测试用例）
• Application parameters：这是触发单个测试的关键，格式为：

  ./wdio.conf.js --spec 你的测试用例路径 [--grep "测试用例名称"]
  

  举个例子：
  • 调试整个测试文件：./wdio.conf.js --spec ./test/e2e/login.test.js
  • 调试文件里的某个具体测试用例（比如某个it块）：./wdio.conf.js --spec ./test/e2e/login.test.js --grep "should login with valid credentials"

3. 启动调试 #

• 在你要调试的测试用例代码行上打个断点（点击行号旁的红点）
• 选择刚才创建好的运行配置，点击调试按钮（绿色虫子图标）
• 这时WebStorm会启动Node.js进程，调用WDIO运行器执行指定的测试用例，触发断点后就能正常调试了

额外注意事项 #

• 确保WebStorm的Node.js解释器配置正确（在「Settings -> Languages & Frameworks -> Node.js and NPM」里选择项目对应的Node版本）
• 如果你的WDIO配置文件里有环境变量或者特定的启动逻辑，调试时会和CLI运行时保持一致，无需额外调整
• 要是找不到wdio.js的路径，可以直接用项目里的npx wdio对应的入口，或者通过which wdio（Mac/Linux）或where wdio（Windows）命令找到路径，再转换成对应的js文件路径

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