VS Code的GitHub Actions扩展对合法工作流语法误报检查错误

• 更新GitHub Actions扩展
  打开VS Code扩展面板（快捷键Ctrl+Shift+X或Cmd+Shift+X），找到GitHub Actions扩展，检查并更新到最新版本。多数误报是旧版本的语法解析bug导致的。

• 重新确认文件语法关联
  打开工作流文件，点击右下角的语言模式标识（应显示“GitHub Actions Workflow”），选择“Configure File Association for '.yml'...”，重新选择“GitHub Actions Workflow”，确保文件类型关联无误。

• 调整if语句引号写法
  Linter对if表达式的引号规则可能有严格要求，尽量统一引号类型并正确转义：

  # 推荐写法，避免引号冲突
  if: '${{ startsWith(github.ref, ''refs/tags/v'') }}'
  

  或者直接使用无引号的表达式写法（GitHub Actions原生支持），减少linter误判：

  if: ${{ startsWith(github.ref, 'refs/tags/v') }}
  

• 忽略secrets上下文的无效警告
  若确认${{ secrets.MY_USERNAME }}这类写法合法，可通过以下方式处理：

  1. 编辑VS Code的settings.json，添加正确的Schema关联：

     "yaml.schemas": {
       "https://json.schemastore.org/github-workflow.json": "*.github/workflows/*.yml"
     },
     "github-actions.workflowValidation.enabled": true
     

  2. 在特定行添加注释忽略单条警告：

     env:
       USERNAME: ${{ secrets.MY_USERNAME }} # yaml-disable-line github-actions/context-invalid
     

• 清除VS Code缓存并重载窗口
  打开命令面板（Ctrl+Shift+P或Cmd+Shift+P），执行“Developer: Reload Window”重载窗口；若仍无效，可手动删除VS Code缓存目录（Windows：%APPDATA%\Code\Cache；macOS：~/Library/Caches/Code；Linux：~/.cache/Code）后重启。

内容的提问来源于stack exchange，提问作者Valentin Vignal