act 速查表
act 是一个在本地运行 GitHub Actions 工作流的工具。无需推送到 GitHub 即可快速验证 CI/CD 流程，极大提高调试效率。基于 Docker 容器运行，支持所有常见事件类型。
更新: 2026-07-20·22 条命令
快速开始
``bash
act # 运行所有工作流（push 事件）
act -l # 列出所有工作流
act -j build # 运行指定 job
act pull_request # 模拟 PR 事件
act --secret-file .secrets # 从文件加载密钥
act --reuse # 重用容器加快速度
``
安装配置(3)
| 命令 | 难度 | ||
|---|---|---|---|
act --help显示 act 帮助信息 | 基础 | act --help | |
act --version显示 act 版本号 | 基础 | act --version | |
.actrcact 默认配置文件（位于项目根目录或 ~/.actrc） | 中级 | # ~/.actrc
-P ubuntu-latest=catthehacker/ubuntu:act-latest
--pull=false |
基本使用(7)
| 命令 | 难度 | ||
|---|---|---|---|
act运行所有工作流（默认触发 push 事件） | 基础 | act | |
act -l列出所有可用工作流及其事件 | 基础 | act -l | |
act -g以图形方式显示工作流结构 | 基础 | act -g | |
act -j运行指定 job（而非整个工作流） | 基础 | act -j test | |
act -W指定工作流文件或目录 | 基础 | act -W .github/workflows/ci.yml | |
act --defaultbranch指定默认分支名称（默认 main） | 中级 | act --defaultbranch master | |
act --container-architecture指定容器架构（如 linux/amd64、linux/arm64） | 中级 | act --container-architecture linux/amd64 |
事件触发(4)
| 命令 | 难度 | ||
|---|---|---|---|
act pull_request模拟 pull_request 事件运行工作流 | 基础 | act pull_request | |
act push模拟 push 事件运行工作流 | 基础 | act push | |
act schedule模拟 schedule 事件运行工作流 | 中级 | act schedule | |
act workflow_dispatch模拟 workflow_dispatch 事件运行工作流 | 中级 | act workflow_dispatch |
密钥环境(4)
| 命令 | 难度 | ||
|---|---|---|---|
act -s设置密钥（多个 -s 可重复使用） | 中级 | act -s MY_SECRET=value | |
act --secret-file从文件加载密钥（每行 KEY=value） | 中级 | act --secret-file .secrets | |
act --env-file从文件加载环境变量 | 中级 | act --env-file .env | |
act --var设置 GitHub Actions 变量 | 中级 | act --var MY_VAR=value |
高级功能(4)
| 命令 | 难度 | ||
|---|---|---|---|
act -P自定义平台与镜像映射（高版本兼容性） | 高级 | act -P ubuntu-latest=catthehacker/ubuntu:act-latest | |
act --pull=false禁止拉取新的 Docker 镜像（使用已缓存的） | 中级 | act --pull=false | |
act --reuse重用上一次运行的容器（加快调试速度） | 中级 | act --reuse | |
act --bind将工作目录绑定挂载到容器（而非复制） | 高级 | act --bind |
常见问题
本速查表数据整理自各工具官方文档。最后更新: 2026-07-20。