GitHub Actions YAML 检查工具
在浏览器中检查 GitHub Actions 工作流 YAML 文件。可发现语法错误(制表符、未闭合引号、重复键)、缺失的必需键(on、jobs)、没有 runs-on 或 steps 的作业,以及未固定版本或使用 @main/@master 的 action 引用,并以严重程度汇总和逐行问题表格的形式呈现。
输入
输出
摘要
| 严重程度 | 数量 |
|---|---|
| No data yet | |
问题
| 行号 | 严重程度 | 消息 |
|---|---|---|
| No data yet | ||
使用此工具的更多方式
REST API
curl -X POST https://api.iotools.cloud/v1/tool/github-actions-yaml-linter \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inputYaml": "name: CI\non: [push]\njobs:\n build:\n runs-on: …",
"hints": "true"
}'替换成您账户中的密钥。工具的字段即为请求体——没有额外包装。
让 AI 代理执行
Use the IOTools `github-actions-yaml-linter` tool (GitHub Actions YAML Linter) on this input:
YOUR_INPUT_HERE将此粘贴给任何已连接 IOTools MCP 服务器的代理,再加上您的输入内容。
嵌入式小组件
<iframe
src="https://iotools.cloud/embed/github-actions-yaml-linter/"
width="100%" height="520" frameborder="0" scrolling="no" loading="lazy"
title="GitHub Actions YAML 检查工具 — iotools.cloud"
sandbox="allow-scripts allow-forms allow-same-origin allow-downloads allow-popups allow-popups-to-escape-sandbox"
allow="clipboard-write"
style="width:100%;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden"></iframe>
<script src="https://iotools.cloud/embed.js" async></script>把它放到您自己的页面上——免费,无需密钥,只需保留一个反向链接。
| 每次 API/MCP 调用费用 | 5 积分起 |
|---|---|
| 需要更多积分? | 查看定价 |
也可通过
使用指南
粘贴 GitHub Actions 工作流文件,即可在浏览器中即时获得逐行的问题报告——在推送有问题的 .github/workflows/*.yml 并等待失败的运行之前就能发现问题。该检查工具在浏览器中解析你的工作流,并依据真正会导致 Actions 构建失败的规则进行检查,然后将结果按严重程度汇总,并列在详细的问题表格中。
检查内容
YAML 语法。 工作流失败最常见的原因是 YAML 格式错误。检查工具会标记用于缩进的制表符(YAML 要求使用空格)、未闭合的引号、同一映射中的重复键,以及缩进与周围代码块不对齐的行。
必需结构。 每个工作流都需要 on: 触发器和 jobs: 代码块。每个普通作业都需要 runs-on: 运行器,并且在 steps: 下至少有一个条目。可复用工作流作业(uses:)不得声明 runs-on 或 steps。缺失或位置错误的键会以错误形式报告,并标明作业名称,便于你准确定位问题。
Action 固定版本与安全性。 通过可移动的分支引用 Action——例如 actions/checkout@main 或 @master——意味着分支一旦变动,构建就会悄然改变,这是一种供应链风险。这类引用会被标记为警告。固定到 @v4 这样的版本标签会触发最佳实践提示,建议第三方 Action 使用完整的提交 SHA。完全没有 @ref 的 Action 则属于错误。
最佳实践提示。 启用提示后,检查工具还会提醒你为长时间运行的作业设置 timeout-minutes,并避免使用 ::set-output:: 和 ::set-env:: 等已弃用的工作流命令。关闭提示则只显示严重错误和警告。
使用方法
- 复制工作流文件的内容,粘贴到输入框中。
- 查看摘要表,快速了解错误、警告和提示的数量。
- 从上到下逐行查看问题表格——每一行都包含行号、严重程度和通俗易懂的说明。
- 修复问题、重新粘贴,重复此过程直到数量为零。
问题表格可以复制,也可以下载为 CSV,用于在拉取请求评审中分享。
我的工作流会被上传到其他地方吗?
不会。所有解析和检查都完全在你的浏览器中通过一个轻量、专门开发的 YAML 解析器完成。你的工作流——包括任何密钥名称或内部作业细节——都不会离开你的设备。
这是完整的 YAML 验证器吗?
它专门针对 GitHub Actions 工作流的结构,因此能理解作业、步骤、运行器、触发器和 permissions,而不是把你的文件当作通用 YAML 处理。正是这种专注,使它能够给出切实可行、贴合 Actions 的反馈,而不只是一句笼统的 "line 12: bad syntax"。