CI 流水线语法错误:无效工作流文件
快速摘要
你的 CI 工作流文件有语法错误 —— CI 系统无法解析流水线定义。
为什么发生
工作流文件使用了 CI 系统不支持的字段或结构
YAML 语法错误如不正确的缩进或缺少冒号
步骤引用了不存在的 action 或使用了错误的输入
最小示例
✗ 错误代码
# .github/workflows/ci.yml
on: push
jobs:
build
runs-on: ubuntu-latest # missing colon after 'build'
steps:
- uses: actions/checkout@v4✓ 修复代码
# .github/workflows/ci.yml
on: push
jobs:
build: # colon added
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4在 'build' 后添加缺失的冒号使 YAML 有效,工作流正确解析。
如何诊断
使用 CI 系统的工作流验证工具检查文件语法
查看 CI 系统文档以获取有效的工作流字段和结构
根据 action 文档检查每个步骤的 action 引用和输入
如何修复
更正工作流文件语法以匹配 CI 系统的模式
修复 YAML 语法错误 —— 缩进、冒号和引号
更新步骤 action 引用和输入以匹配 action 的接口
如何预防
在提交更改前使用 CI 系统的工作流 linter 或验证工具
保持工作流文件简单并在 CI 中用空运行充分测试