webstorm 默认识别 .github/workflows yaml 文件，但需手动启用 github actions 检查、绑定官方 schema 并安装插件，才能获得参数补全、错误提示、依赖跳转等完整支持；${{...}} 表达式仅静态解析，不执行或推导运行时值。
WebStorm 默认就能识别 .github/workflows 目录下的 YAML 文件并提供基础支持，但“预览”不是开箱即用的功能——它依赖于你是否启用了语法检查、上下文补全和环境变量解析等具体能力。只要配置到位，你能在编辑时看到参数提示、错误标红、needs 依赖跳转，甚至 ${{ github.event.pull_request.head.sha }} 这类表达式也能被部分推导。
确认 GitHub Actions 检查已启用
WebStorm 不会默认开启所有 GitHub Actions 相关的静态检查，必须手动勾选。否则即使 YAML 格式正确，uses: actions/checkout@v5 写错版本也不会报错，env.* 引用未定义变量也无提示。
- 打开
Settings / Preferences（快捷键Ctrl+Alt+S） - 进入
Editor → Inspections → GitHub Actions - 确保勾选以下几项：
Undefined action、Undefined job dependency、Invalid parameter value、Circular job dependencies - 如果项目里用到了自定义本地 action（比如
./.github/actions/my-deploy），还要确认Undefined local action已启用
补全和导航失效？检查 YAML Schema 绑定
WebStorm 靠 YAML Schema 来理解 GitHub Actions 的结构，如果没绑定或绑定错误，runs-on 下拉不出现 ubuntu-latest、steps 里输 uses: 没补全，都是 Schema 缺失导致的。
- 在
.github/workflows/*.yml文件中右键 →Override YAML Schema - 选择
GitHub Actions workflow schema（不是通用 YAML 或空值） - 若列表里没有该选项，说明插件未加载：前往
Settings → Plugins，搜索并启用GitHub Actions插件（JetBrains 官方插件，非第三方） - 重启 WebStorm 后，再打开工作流文件，
on:下的事件名（如pull_request）、permissions:的键名都会触发补全
${{ ... }} 表达式无法解析？这是正常限制
WebStorm 能高亮 ${{ github.actor }} 并提示字段，但不会动态计算或模拟运行时值——它不执行表达式，只做静态结构匹配。所以别指望它告诉你 ${{ matrix.os }} 在当前 job 中实际是 ubuntu-22.04 还是 macos-14。
- 对
matrix、strategy等动态生成的上下文，WebStorm 只能基于 schema 做有限提示，不会读取整个 workflow 推导可能取值 -
steps.*.outputs的跨 step 引用（如${{ steps.build.outputs.version }}）仅在目标 step 已定义outputs:且格式合规时才可跳转，否则提示 “Unresolved reference” - 若想验证表达式逻辑，仍需提交后看 GitHub Actions 日志，WebStorm 不替代 runner
真正容易被忽略的是：WebStorm 对 workflow_call 触发器和重用工作流（uses: ./.github/workflows/deploy.yml）的支持较弱。路径补全可能失效，inputs 参数不会自动关联到调用处的 with: 块。这部分得靠人工核对 schema 和文档，IDE 帮不上太多。
