本地调试工作流脚本简易教程
环境准备
1. 克隆仓库
# 官方仓库
git clone https://gitea.com/gitea/act.git
# 或者使用镜像仓库
git clone https://devstar.cn/actions/act.git
2. 编译 act
make build
编译完成后，可执行文件位于 dist/local 文件夹下。
3. 安装 act
# 将 act 复制到系统 PATH 中
sudo cp dist/local/act /usr/local/bin/
调试方法
方法一：命令行调试
📖 官方文档: https://nektosact.com/
常用命令
| 命令 | 描述 |
|---|---|
act --list 或 act -l |
列出所有可用的工作流 |
act |
运行所有工作流 (push 事件) |
act pull_request |
运行特定事件 |
act -j test |
运行特定 job |
act --workflows .gitea/workflows/ |
指定工作流目录 |
act -h |
显示帮助信息 |
重要提示
⚠️ 调试 Gitea 工作流时，请务必使用 -W 参数指定工作流目录：
act -W .gitea/workflows/devstar-studio-dev-ci.yaml
方法二：VS Code 插件图形化界面调试
1. 安装扩展
在 VS Code 中安装 Github Local Actions 扩展。
2. 环境确认
安装完成后，请确保以下环境已就绪：
- ✅ Docker 已安装并正常运行
- ✅ act 已安装到系统 PATH
3. 配置工作流目录
在 VS Code 设置中搜索 workflow 关键字，将工作流目录设置为 .gitea/workflows：
4. 使用插件
插件会自动识别相关的工作流文件：
可以在此处输入变量等配置内容：
点击绿色箭头开始调试：
注意事项
⚠️ 重要提示：调试时请确保 Docker 可以正常访问外网。