github actions插件在vscode中不支持实时状态更新，仅提供手动刷新的只读视图，日志不内联输出；需手动启用侧边栏、配置github token、确认.git仓库及.github/workflows路径存在。
GitHub Actions 插件在 VSCode 中不能真正实时更新状态，它只提供手动刷新的只读视图，日志也不内联流式输出——这点必须先说清，否则你会反复点刷新却等不到最新 in_progress 状态。
安装后侧边栏不显示 GitHub Actions 面板
插件装完默认不自动打开面板，必须手动激活：
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入GitHub Actions: Toggle Sidebar并执行 - 确认当前工作区已打开一个 Git 仓库（即目录下有
.git），否则插件无法识别上下文 - 若仍为空，右键侧边栏空白处选
Refresh Workflows；如提示“no workflows found”，检查是否漏建了.github/workflows/目录（注意开头的点和大小写）
GitHub Actions: Set GitHub Token 为什么必须做
没配 token 时，插件只能读取公开仓库的元数据（比如 workflow 名称、触发时间），但以下功能全部失效：
- 点击 job 查看日志 → 跳转到 GitHub 页面，而非 VSCode 内嵌终端
- 重试失败的 job → 按钮灰掉或点击无响应
- 私有仓库的运行记录 → 返回空列表或
404
token 只需 repo 和 workflow 权限，生成后通过命令面板执行 GitHub Actions: Set GitHub Token 粘贴即可。VSCode 会安全存储，无需明文写进配置文件。
想“近实时”看状态？别依赖插件自带刷新
插件底层调用的是 /actions/runs REST API，**没有轮询逻辑**，也不监听 Webhook。所谓“自动刷新”是假象——它只在你打开面板、切换 workflow 或手动点 ↻ 时才拉一次数据。
- 正在运行的 job 卡在
in_progress是常态，可能持续数分钟，直到你主动刷新 - 如真需每 15–30 秒查一次最新状态，得自己写轻量扩展：用
@octokit/rest调listWorkflowRuns，配合setTimeout递归轮询，且首次延迟 3 秒防抖 - 更务实的做法是：用
gh run list --limit 3（ghCLI）在 VSCode 终端里手动查，比等插件刷新快得多
编辑时语法报错但 workflow 在 GitHub 上能跑
这是常见错觉。VSCode 的校验基于 YAML Schema（来自 SchemaStore），它比 GitHub Actions 实际运行时更严格：
- 例如
if条件中用了contains函数但未加引号：if: contains(github.event.pull_request.labels.*.name, 'ci')→ 插件报错，但 GitHub 运行时接受 - 又如
uses: ./path/to/action本地路径引用，插件无法解析 schema，标红，但推送后 GitHub 能正确加载 - 解决方法：保存前执行
act -n（dry-run）验证逻辑，或用gh workflow validate做线上级校验
真正容易被忽略的，是插件对 GHES（GitHub Enterprise Server）支持极弱——API 路径和版本差异常导致 404 或空响应，此时 token 和网络都没问题，只是插件没适配你的企业版 API 版本。
