最快速解法是删除所有Tab并替换为空格；YAML严禁Tab缩进，GitLab解析器遇Tab会报模糊错误如“did not find expected key”，需用grep、cat -A定位，sed替换，或配置编辑器自动转空格并启用gitlab-ci-local预检。
直接删掉 Tab，全部换成空格——这是最快速、最确定的解法。YAML 规范明确禁止使用制表符（Tab）缩进，GitLab CI 解析器在遇到 Tab 时不会报“发现 Tab”，而是报类似 did not find expected key、could not find expected ':' 或直接显示 invalid yaml 的模糊错误，让人误以为是语法或逻辑问题。
用命令行快速定位和清理 Tab
在项目根目录执行以下命令，能立刻暴露所有藏在 .gitlab-ci.yml（及可能存在的 .gitlab-ci-local-variables.yml）里的 Tab：
-
查找含 Tab 的行：
grep -n $'\t' .gitlab-ci.yml -
可视化所有空白符（空格变·，Tab变→）：
cat -A .gitlab-ci.yml，一眼识别 → 字符 -
一键替换为 2 空格缩进（谨慎使用，建议先备份）：
sed -i 's/\t/ /g' .gitlab-ci.yml
编辑器层面永久规避
别等报错才补救。在 VS Code、JetBrains 系 IDE 或 Vim 中统一设置：
- 开启「显示空白字符」（如 VS Code 的
editor.renderWhitespace: "all"），Tab 会显示为 `→`，空格为 `·` - 设置「插入空格代替 Tab」：
editor.insertSpaces: true - 固定缩进宽度为 2：
editor.tabSize: 2 - 为 YAML 文件强制启用上述规则，在
.vscode/settings.json中加："[yaml]": { "editor.insertSpaces": true, "editor.tabSize": 2 }
本地预检：用 gitlab-ci-local 提前捕获
安装 gitlab-ci-local 后，运行以下命令不依赖 GitLab 服务器，就能验证配置是否可被正确解析：
-
gitlab-ci-local --list—— 若报错，基本就是 YAML 格式问题，且错误信息比 GitLab Web 界面更具体 -
gitlab-ci-local --shell—— 模拟真实 Runner 执行环境，还能暴露路径、变量、脚本换行等衍生问题 - 配合
--verbose可看到解析器逐层加载过程，快速锁定出错行号
CI 流程中自动拦截（防患于未然）
把格式校验变成提交前硬性门槛：
- 在项目根目录加
.pre-commit-config.yaml，引入pre-commit-hooks的yamllint - 或在
.gitlab-ci.yml最前面加一个 lint job：
