VSCode本身不运行GitHub Actions，但通过安装官方插件、将文件置于.github/workflows/路径、切换语言模式为GitHub Actions，可实现精准编写、语法校验与本地模拟执行；禁用Red Hat YAML等冲突插件，配合act CLI验证逻辑，避免推送后才发现错误。

VSCode 本身不运行 GitHub Actions，但能让你在编辑器里写得准、试得快、看得清——关键不是“能不能跑”，而是“怎么避免推上去才发现错”。只要三件事做对：装对插件、放对路径、配对语言模式，后续所有补全、校验、触发、日志查看才真正可用。

必须安装 GitHub Actions 官方插件并禁用 Red Hat YAML

VSCode 默认把 .yml 当普通 YAML 处理，根本识别不了 on、jobs、uses 这些 GitHub Actions 特有字段。只有 GitHub 官方插件（发布者是 GitHub）注册了 github-actions 语言模式，才能激活语义补全和 schema 校验。

• 在扩展市场搜 GitHub Actions，只认发布者为 GitHub 的那个，别选 Red Hat YAML 或其他 YAML 类扩展
• 如果已装过 Red Hat YAML，必须先禁用或卸载——它会劫持 .yml 文件的语言模式，导致官方插件完全失效
• 安装后重启 VSCode，或手动按 Ctrl+Shift+P → Change Language Mode → 选 GitHub Actions，否则文件仍被识别为纯 YAML

工作流文件必须严格放在 .github/workflows/ 下

插件只扫描标准路径。放错位置，哪怕语法完美，也不会触发任何校验、补全或侧边栏显示。

Pilot Digital Twin Setup

部署一个包含 4 个智能体（agent）的数字孪生平台。在以下情况下使用该技能： 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……

下载

• 路径必须是项目根目录下的 .github/workflows/ci.yml（注意开头的点、全小写、斜杠方向）
• 文件名可以是 ci.yml、test.yaml 等，但后缀只能是 .yml 或 .yaml
• 如果放在 config/workflow.yml 或 .github/workflow.yml（少个 s），插件不会扫描，gha 代码片段也无效
• VSCode 必须以 Git 仓库为工作区打开（不是只打开单个文件），否则插件无法识别上下文

用 gha 代码片段生成模板再手动改 trigger

手动拼 name、on、jobs 极易漏字段或缩进错。插件内置的 gha 片段能一次生成合法骨架，省去查文档时间。

• 在 .github/workflows/ci.yml 中输入 gha 后按 Tab，选择 GitHub Actions: Basic Workflow
• 自动生成含 on、jobs、steps 的结构，光标默认停在 on: 行，方便你立刻改成 push、pull_request 或带 branches 的对象
• 别直接复制网上示例——很多老教程用 actions/checkout@v2 或漏 with: 缩进，VSCode 会立刻在问题面板报 Missing property "with"

本地验证靠 act CLI，不是靠 VSCode 插件

VSCode 插件只管“写得合规矩”，不管“跑得通不通”。很多逻辑错误要等 act 本地跑或推到 GitHub 才暴露。

• 装 act：brew install act（macOS）或 npm install -g act
• 在 VSCode 集成终端中执行 act -j test（指定 job 名），看是否拉镜像、checkout、执行 run 命令
• 常见踩坑点：run: gawk '{print $1}' 在 ubuntu-latest 镜像里根本没装 gawk；${{ secrets.MY_TOKEN }} 是否真在仓库 Settings → Secrets 里配过；matrix.node 引用少一对 {{}} 就静默失效
• 可把 act 命令配置进 .vscode/tasks.json，按 Ctrl+Shift+P → Tasks: Run Task 一键触发，避免反复敲命令

最容易被忽略的是：插件和 act 是两套机制。插件帮你写对格式，act 帮你试通逻辑——缺一不可。写完一个 ci.yml，不跑一遍 act，等于没验证。