Skip to content

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 中用空运行充分测试

相关资源

相关术语

相关课程

← 返回语言