如何在GitLab中使用多标签运行Playwright测试？

核心原因 #

本地命令里的'tag1 | tag2 | tag3'单引号是用来阻止shell解析内部的|管道符，但在GitLab CI中直接调用$Tags时，shell会把变量中的|当成管道命令处理，导致参数传递错误，进而无法正确匹配测试用例。

正确配置方案 #

方案1：适配-g参数的正则匹配 #

• GitLab CI变量设置：将Tags变量的值设为 tag1|tag2|tag3（无需加引号、无需转义，直接用|分隔标签）
• gitlab-ci.yml脚本：

  script:
    - npx playwright test -g "$Tags"
  

  用双引号包裹$Tags，确保shell将整个变量值作为单个参数传递给Playwright，不会把|解析为管道符。

如果本地命令中的空格是正则的一部分（比如测试标签包含空格），只需把变量值改为 tag1 | tag2 | tag3，脚本保持不变即可。

方案2：更精准的标签匹配（推荐） #

如果是专门针对测试标签而非测试标题进行匹配，建议使用Playwright的--grep-tags参数，语法更直观：

• GitLab CI变量设置：Tags值设为 tag1||tag2||tag3（用双竖线分隔多个标签，表示“或”关系）
• gitlab-ci.yml脚本：

  script:
    - npx playwright test --grep-tags "$Tags"
  

验证步骤 #

可以在CI脚本中添加打印命令，确认变量传递是否正确：

script:
  - echo "当前匹配标签：$Tags"
  - npx playwright test -g "$Tags"

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