GitHub Actions 工作流生成器

选择要做的事——自动测试、发布 Docker 镜像、部署到 GitHub Pages 或自己的服务器、打标签发布 Release、定时执行脚本,再设置触发条件、版本矩阵、缓存和权限,生成可以直接放进仓库 .github/workflows 目录的 YAML 文件。官方 Action 使用 2026 年 10 月核对过的最新主版本。

触发条件

使用说明

  • 放在哪里:把文件保存为仓库中的 .github/workflows/文件名.yml,推送后在仓库的 Actions 页面就能看到运行记录。
  • 密钥放在 Secrets:服务器地址、SSH 私钥、令牌等在仓库 Settings → Secrets and variables → Actions 中添加,工作流里用 ${{ secrets.名称 }} 引用,日志中会自动打码。推送到 GHCR 和创建 Release 使用自带的 GITHUB_TOKEN,不需要另外配置。
  • 定时任务用 UTC:cron 按 UTC 时间执行,北京时间早上 9 点要写 0 1 * * *;高峰时段可能延迟十几分钟,仓库 60 天没有活动时定时任务会被自动停用。
  • 最小权限:生成的工作流在顶部声明 permissions,只申请需要的权限,第三方 Action 被攻破时影响更小。安全要求高的项目可以把 Action 固定到完整的提交 SHA。
  • 免费额度:公开仓库使用 GitHub 托管的运行器免费;私有仓库每月有一定的免费分钟数,macOS、Windows 运行器按更高的倍率计算。

cron 表达式可以用 Crontab 表达式生成器 调试;Docker 镜像的构建文件可以用 Dockerfile 生成器 生成。

GitHub Actions 工作流生成器常见问题

GitHub Actions 工作流生成器怎么使用?

点选模板,填写版本、包管理器、构建命令等选项,设置推送分支、标签、定时、拉取请求和手动运行等触发条件;右侧生成 YAML 并显示应保存的文件路径和配置提醒,复制或下载后放进仓库的 .github/workflows 目录。

GitHub Actions 的配置文件放在哪里?

放在仓库的 .github/workflows 目录下,文件名任意,扩展名为 .yml 或 .yaml。

定时任务的时间是北京时间吗?

不是,cron 使用 UTC 时间,北京时间要减去 8 小时。

怎么在工作流中使用密码?

在仓库 Settings → Secrets 中添加,工作流里用 ${{ secrets.名称 }} 引用。

GitHub Actions 免费吗?

公开仓库使用 GitHub 托管的运行器免费,私有仓库每月有免费分钟数。

GitHub Actions 工作流生成器的结果应怎样理解?

模板覆盖常见用法,复杂的项目需要在生成结果上调整;Action 版本为 2026 年 10 月核对的最新主版本,之后可能有新版本发布。

输入内容会保存或发给外部服务吗?

所有内容在浏览器本地生成,不会上传。

没有结果或操作失败时先检查什么?

工作流没有运行,检查文件是否在 .github/workflows 目录、扩展名是否为 .yml,以及推送的分支是否与触发条件一致;YAML 缩进必须使用空格。

相关工具

Docker Compose 生成器 · docker run 命令生成器 · HMAC 签名生成与验证 · OpenAPI / Swagger 文档查看器 · 全部开发工具