若 VSCode 中 GitHub Actions 插件无法显示工作流状态，需依次检查：一、插件是否登录 GitHub 账户；二、工作流文件是否位于 .github/workflows/ 目录且格式正确；三、是否手动刷新运行记录；四、当前工作区是否为已关联 GitHub 远程的 Git 仓库。
如果您在 VSCode 中安装了 GitHub Actions 插件，但无法正确显示工作流的运行状态，则可能是由于插件未正确连接到 GitHub 账户、仓库配置不匹配或工作流文件未被识别。以下是查看工作流运行状态的具体操作方式：
本文运行环境：MacBook Air M2，macOS Sequoia。
一、确认插件已启用并完成身份验证
GitHub Actions 插件需通过 GitHub OAuth 授权访问您的账户和仓库信息，未完成登录将无法拉取任何运行状态数据。
1、点击 VSCode 左侧活动栏中的 GitHub Actions 图标（蓝色齿轮形状）。
2、若插件顶部显示 “Sign in to GitHub”，点击该链接跳转至浏览器完成授权。
3、授权完成后返回 VSCode，插件应自动刷新并显示当前打开仓库的 workflows 文件夹。
二、检查工作流文件是否位于标准路径
插件仅扫描 .github/workflows/ 目录下的 YAML 文件，若文件存放位置不符合规范，将不会被识别为可监控的工作流。
1、在 VSCode 资源管理器中展开项目根目录，确认存在 .github/workflows/ 子路径。
2、检查该路径下是否存在扩展名为 .yml 或 .yaml 的文件，且文件内容以 name: 和 on: 开头。
3、若工作流文件位于其他路径（如 /ci/ 或根目录），需将其移入 .github/workflows/ 并保存。
三、手动触发工作流状态刷新
插件默认不会实时轮询 GitHub API，需主动触发更新才能获取最新运行记录。
1、在 GitHub Actions 视图中右键点击任一工作流名称。
2、从上下文菜单中选择 “Refresh Runs”。
3、观察状态栏是否出现加载动画，完成后刷新图标旁应显示最近一次运行的 状态徽章（如 green check 或 red x）。
四、切换工作区以匹配目标仓库
插件状态依赖当前打开的 VSCode 工作区所关联的 Git 仓库，若打开的是子模块或未初始化 Git 的文件夹，则无法定位对应 GitHub 仓库。
1、按下 Cmd+Shift+P（macOS） 打开命令面板。
2、输入并选择 “Git: Clone” 或确认当前工作区已执行过 git init 且远程地址为 GitHub URL。
3、在资源管理器顶部检查文件夹名右侧是否显示 GitHub 仓库图标与分支名称。
