vscode 无法真正调试 github actions，只能通过三步协同：yaml 语法校验（插件高亮/补全/缩进检查）、act 本地模拟执行（需 docker，注意环境差异）、vscode 内嵌查看云端真实日志（需配置 token 并手动刷新）。
VSCode 本身不能调试 GitHub Actions，所谓“调试”实际是三件事：写对 YAML、本地模拟执行、在编辑器里查真实日志——缺一不可，跳过任一环节都可能推上去才发现失败。
VSCode 插件只负责语法和结构校验，不运行也不调试
装了 GitHub 官方的 GitHub Actions 扩展后，它能做的事很明确：
- 高亮
on、jobs、uses等字段，悬停看参数说明 - 输入
gha+ Tab 自动补全合法骨架，缩进和空格都按 schema 对齐 - 检查
pull_request_target这类事件名拼写是否有效，但不会验证run: npm test在 ubuntu-latest 上是否存在npm - 跳转到
uses: actions/checkout@v4的公开仓库定义（需网络+插件未被 Red Hat YAML 覆盖）
常见误判：状态栏报 GitHub Actions: Invalid workflow file 却没定位行号——大概率是缩进混用了空格和 Tab，右下角看是不是显示 Tab Size: 2；或者 branches: main 少了中括号，被 YAML 解析成字符串而非数组。
用 act 在本地模拟执行，不是“预览”，是真跑
act 是目前唯一能接近真实 runner 行为的本地工具，但它不是万能的：
super-github-s
下载
使用 `gh` CLI 与 GitHub 交互。使用 `gh issue`、`gh pr`、`gh run` 和 `gh api` 处理 Issue、PR、CI 流程及高级查询。
- 必须提前启动
dockerd（macOS 用 Docker Desktop 或 Colima 均可） - 默认拉的是
nektos/act-environments-ubuntu:18.04，和 GitHub 官方ubuntu-latest有差异，比如缺少gawk或新版git - 若 workflow 指定
runs-on: macos-latest，act直接报错不兼容，没法模拟 - 多行脚本用
|时，后续每行必须比|所在行多缩进至少 2 格，否则解析失败报could not find expected ':' - 引用本地 action（如
uses: ./actions/my-build）需加-P ./actions=myorg/my-action显式映射路径
推荐在 .vscode/tasks.json 里配一个 task："command": "act -j build"，避免每次敲长命令。
在 VSCode 里看真实日志，得靠 GitHub Token 和手动刷新
插件侧边栏的 GitHub Actions 面板不是实时推送，而是定时拉取（默认 60 秒），且依赖认证：
- 必须通过命令面板执行
GitHub Actions: Set GitHub Token，权限只需repo和workflow - Token 没配或失效时，点击 job 只会跳转 GitHub 页面，无法在 VSCode 内嵌终端查看日志
- 面板为空？先确认当前工作区是 Git 仓库根目录（含
.git），且存在.github/workflows/ci.yml（注意点号和小写） - 日志是流式输出，但不支持关键词搜索或折叠所有步骤，关键错误容易被滚动刷走
真正容易被忽略的是：插件里的 “▶ Run workflow” 按钮触发的是远程执行，不是本地模拟——它发的是 GitHub API 请求，等同于你在网页点 Run，日志也是从云端拉的。别把它和 act 搞混。
