必须以Git仓库根目录打开项目且路径为.github/workflows/，否则插件无法加载上下文；on字段需严格缩进（空格）、大小写正确，并手动切换语言模式为GitHub Actions才能触发工作流。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Windows 10上配置Codex与GitHub Actions插件后，工作流仍不触发、侧边栏空白或状态栏报“Invalid workflow file”，说明CI流水线的触发条件未被正确识别——这通常不是插件没装好，而是on:字段写法、路径位置或Git上下文缺失导致的硬性拦截。
确认VSCode是否以Git仓库为工作区打开
直接双击打开单个.yml文件，插件完全无法加载上下文。必须通过“文件→打开文件夹”，选择包含.git子目录的项目根目录。
打开后按Ctrl+Shift+P→输入Git: Show Git Output，若能看到Git日志输出，说明工作区识别成功；若提示“Not in a git repository”，请立即关闭窗口，重新用文件夹方式打开。
【关键前提】插件所有功能（包括gha代码片段、侧边栏Workflows列表、语法校验）都依赖Git仓库上下文，缺此一步，后续全部失效。
检查.github/workflows/路径是否严格合规
路径必须是项目根目录下的.github\workflows\ci.yml（Windows下反斜杠不影响识别，但名称大小写和点号不可错）。
常见错误：放在config/workflow.yml、.github/workflow.yml（少s）、GH_WORKFLOWS/ci.yml——这些路径VSCode插件根本不会扫描。
在资源管理器地址栏中手动输入%USERPROFILE%\your-project\.github\workflows，确认该目录真实存在且可访问。若不存在，右键新建文件夹，名称必须精确输入.github（开头的点不能省略，输入后回车确认）。
用gha代码片段生成合法on字段结构
方法一：在.github/workflows/ci.yml中输入gha后按Tab，选择GitHub Actions: Basic Workflow。
自动生成的模板默认含on: [push]，光标停在此行末尾，此时可直接编辑为：
本地项目发布到GitHub的完整工作流助手。自动执行：安全检查（.gitignore、排除敏感.env/凭据文件）、补齐开源文件（LICENSE、.gitignore）、git init/commit/branch、创建远程仓库、首次推送、可选打tag。支持git filter-repo历史敏感信息重写、force push、tag管理。Windows下走Credential Manager自动认证。触发词："发布到GitHub"、"上传到github"、"
on: push: branches: - main - develop
注意：缩进必须用空格，且branches:下每项前必须有4个空格（2级缩进），- main前必须有6个空格（3级缩进）。用Tab键会破坏解析，导致“Expected a mapping”报错。
方法二：若需PR触发，替换为：
on: pull_request: branches: - main
切勿写成on: pull_request（无缩进）或on: [pull_request]（数组写法不支持分支过滤）。
验证YAML语法并强制切换语言模式
第一步：右键编辑器空白处→Change Language Mode→选GitHub Actions。若列表里没有该选项，说明Red Hat YAML插件正在劫持，必须先禁用它。
第二步：按Ctrl+Shift+P→运行Developer: Toggle Developer Tools→控制台中查看是否有github-actions language server activated日志。没有则重启VSCode再试。
第三步：保存文件后，观察左下角状态栏。若显示GitHub Actions (v1.12.0)且无红色波浪线，说明语法层已通过；若显示YAML或持续报Invalid workflow file，说明语言模式未生效或缩进存在隐藏制表符。
第四步：打开命令面板→GitHub Actions: Refresh Workflows，强制重载侧边栏列表。此时应出现可点击的workflow节点。
