VSCode 通过 GitHub Actions 官方插件实现工作流的编辑、查看、触发与日志分析，支持语法高亮、智能提示、实时日志、失败跳转及配合 gh CLI 和 act 进行本地调试。
VSCode 本身不直接运行 GitHub Actions，但通过插件和内置功能可以实现便捷的集成与可视化监控。核心在于利用官方或社区插件连接 GitHub 仓库，拉取工作流状态，并在编辑器内查看日志、触发执行、跳转到失败步骤等。
安装 GitHub Actions 插件
打开 VSCode 扩展市场（Ctrl+Shift+X），搜索并安装 GitHub Actions（由 GitHub 官方维护，图标为 Octocat）。该插件支持 YAML 工作流语法高亮、智能提示、验证，以及从侧边栏查看工作流列表和运行历史。
- 安装后需登录 GitHub 账号（点击左侧活动栏中的 GitHub 图标 → Sign in to GitHub）
- 确保当前打开的文件夹是已 git clone 的 GitHub 仓库，且包含
.github/workflows/目录 - 插件会自动识别
.yml或.yaml工作流文件，并在编辑时提供 lint 提示（如 missing `on` trigger、invalid runner）
在编辑器内查看与触发工作流
点击左侧活动栏的 GitHub 图标，展开 Actions 视图，即可看到当前仓库所有工作流及其最近运行记录。每条运行显示状态（✅ / ❌ / ⏳）、分支、触发事件和耗时。
- 点击某次运行可展开详细步骤，查看每个 job 的日志输出（支持折叠/展开、关键词搜索）
- 右键任意工作流名称，选择 Run Workflow 可手动触发（支持填写输入参数，若 workflow 定义了
inputs） - 失败步骤旁会出现红色波浪线，悬停可看错误摘要；点击可跳转到对应日志行
实时日志与问题定位
插件默认加载最近 100 行日志，但可点击日志窗口右上角的 Load more 按钮获取完整输出。对于长时间运行的 job（如构建或测试），日志会随运行实时刷新。
- 日志中带颜色的关键字（如 Error、Warning）会被高亮，便于快速扫视
- 点击日志中的文件路径（如
src/main.ts:42）可直接跳转到对应代码位置 - 若某 step 使用了
actions/setup-node@v4等常见动作，插件会显示其版本兼容性提示（如“v4 requires Ubuntu-22.04 or later”）
配合 GitHub CLI 增强本地调试
仅靠插件无法在本地完全模拟 Actions 运行环境，但搭配 gh CLI 可提升效率。例如，在终端中运行 gh run list 或 gh run view <id></id> 可补充查看插件未展示的元数据（如 runner IP、trigger payload）。
- 安装 GitHub CLI 后，在 VSCode 集成终端中执行
gh run rerun --failed可重试所有失败 job - 用
gh run download <id></id>下载产物（如打包后的 dist/ 文件），无需离开编辑器 - 结合
act（第三方工具）可在本地运行部分 workflow，VSCode 中通过终端启动act -j build即可快速验证逻辑
基本上就这些。不需要离开 VSCode 就能完成大多数 Actions 日常操作——写、查、调、修。关键不是替代 GitHub.com 页面，而是把高频动作收进编辑器，让反馈更近一步。
