GitLab CI Runner标签配置问题：iOS任务未在流水线UI显示

先确认分支匹配规则 #

你的任务配置了only: - deploy/app，先检查触发流水线的分支是否完全精准匹配deploy/app——分支名区分大小写，比如Deploy/App或deploy-app都会导致任务不触发。可以临时将only改为- branches或者直接注释掉，手动触发流水线，看任务是否会出现，以此排除分支过滤的问题。

检查Runner标签与状态匹配 #

你的任务要求Runner同时拥有apple和shell两个标签，前往GitLab项目的Settings > CI/CD > Runners，找到目标OSX Runner：

• 确认它的标签栏是apple shell（空格分隔两个标签，而非仅其中一个）
• 确认Runner处于激活状态（未被禁用）
• 确认该Runner是项目专属Runner，或是该项目有权使用的组Runner

验证Runner的本地运行状态 #

登录到OSX Runner所在的机器：

• 执行gitlab-runner verify命令，检查Runner与GitLab服务器的连接是否正常
• 打开Runner配置文件（通常路径为~/.gitlab-runner/config.toml），确认executor字段为shell，且tags字段确实包含apple和shell

查看流水线隐藏任务 #

有些任务会因前置阶段失败或规则不满足被跳过，但UI默认可能不显示：

• 进入流水线页面的Jobs标签页
• 点击右上角的Show all jobs，查看是否有状态为skipped的app-ios任务，点进去可查看具体跳过原因（GitLab会明确提示是分支不匹配还是Runner不可用）

检查CI配置语法正确性 #

将你的.gitlab-ci.yml内容复制到GitLab项目的CI/CD > Editor，点击右上角的Validate按钮，排查是否存在语法错误——比如缩进错误（YAML必须用空格缩进，不能用Tab）、字段拼写错误等。

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