需安装 GitHub 官方 GitHub Actions 扩展并完成 OAuth 登录，启用侧边栏工作流面板后可查看、手动触发 workflow_dispatch 工作流及逐级分析日志。
如果您在使用 VSCode 编辑代码时希望直接查看、触发或调试 GitHub Actions 工作流，但发现编辑器中缺少可视化支持或操作入口，则可能是由于缺少对应扩展或配置未生效。以下是实现该功能的具体方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 GitHub Actions 扩展
VSCode 本身不内置 GitHub Actions 管理功能，需通过官方认证的扩展提供工作流浏览、日志查看及手动触发能力。该扩展由 GitHub 官方维护，与 GitHub API 深度集成。
1、打开 VSCode，点击左侧活动栏中的扩展图标（或按快捷键 Ctrl+Shift+X）。
2、在搜索框中输入 GitHub Actions，找到发布者为 GitHub 的官方扩展。
3、点击“安装”，安装完成后重启 VSCode 或点击“重新加载”按钮。
4、确保当前工作区已关联 GitHub 仓库（即本地目录包含 .git 文件夹且远程 origin 指向 GitHub 仓库）。
二、启用 GitHub 身份验证
扩展需访问 GitHub API 获取工作流列表、运行状态和日志，因此必须完成 OAuth 授权。未登录将导致工作流面板为空或显示“Not signed in”提示。
1、按下 Cmd+Shift+P（macOS）调出命令面板。
2、输入并选择 GitHub: Sign In 命令。
3、选择 Sign in with a browser，系统将自动打开浏览器跳转至 GitHub 授权页。
4、勾选 workflow:read 和 workflow:write 权限后授权。
5、浏览器关闭后，VSCode 将自动完成会话同步，状态栏右下角显示 GitHub 头像图标。
三、查看工作流面板
扩展安装并登录后，VSCode 侧边栏将新增 GitHub Actions 专用面板，用于集中展示所有工作流定义文件、历史运行记录及实时状态。
1、点击左侧活动栏最下方的 GitHub Actions 图标（齿轮与箭头组合图标）。
2、面板顶部显示当前仓库名称，下方以树形结构列出 .github/workflows/ 目录下的全部 YAML 文件。
3、点击任一工作流文件名，右侧将展开其最近三次运行记录，含状态徽章（✅ / ❌ / ⏳）、触发事件、提交哈希及运行时间。
4、点击某次运行条目，底部面板将自动切换为该次运行的完整作业图谱与日志流。
四、手动触发工作流
对于设置了 workflow_dispatch 事件的工作流，可在 VSCode 内直接发起运行，无需切换网页端。该方式支持传递输入参数，适用于测试与部署场景。
1、在 GitHub Actions 面板中，右键点击目标工作流文件名。
2、选择 Run Workflow 选项。
3、若该工作流定义了 inputs 字段，将弹出输入表单，按提示填写各字段值。
4、点击 Run 后，面板立即刷新，新增一条带 queued 状态的运行记录。
五、查看与筛选运行日志
日志查看功能支持逐级展开作业、步骤与命令输出，便于快速定位失败原因。面板默认仅加载最近 100 行，可动态加载更多。
1、在某次运行详情页中，点击左侧作业节点（如 build），右侧显示该作业下所有步骤。
2、点击步骤名称（如 Run actions/setup-node@v4），下方展开该步骤的完整终端输出。
3、使用面板顶部的 Filter logs 输入框，键入关键词（如 error 或 npm ERR）进行高亮筛选。
4、右键任意日志行，选择 Copy log line 或 Copy output 进行快速复现分析。
