为何VS Code对有效Azure Pipelines YAML文件报代码检查错误？

我有一个有效的pipeline.yaml文件，在DevOps Pipeline中运行时可成功执行，但在VS Code中编辑时，以下代码段出现波浪线标注：

stages:
- stage: deployResources
  displayName: 'Deploy resource group'
  jobs:
  - job: deploymentGroup
    displayName: 'run deployment group'
    steps:
    - task: AzureResourceManagerTemplateDeployment@3
      inputs:
        ...

弹出提示信息为：

String does not match the pattern of "^PowerShell@2$".yaml-schema: Azure Pipelines

这个情况不少开发者都遇到过，大概率是Azure Pipelines VS Code扩展的Schema缓存/同步异常，不是你的YAML语法或本地配置错误。

可能原因 #

• 扩展内置的Pipeline Schema未及时更新，或是本地缓存的Schema文件损坏，导致无法识别AzureResourceManagerTemplateDeployment@3任务，错误套用了PowerShell任务的校验规则。
• 极少数情况是工作区配置里手动指定了错误的Schema路径，强制任务节点匹配PowerShell@2的规则。

解决步骤 #

• 刷新Schema缓存：打开VS Code命令面板（Ctrl+Shift+P / Cmd+Shift+P），执行Azure Pipelines: Refresh Pipeline Schemas，等待扩展重新拉取最新的任务Schema。
• 重置扩展配置：打开VS Code设置，搜索Azure Pipelines相关选项，确认没有手动指定错误的Schema文件路径，有就恢复默认；也可以禁用再重新启用扩展，重启VS Code后重试。
• 临时手动指定Schema：如果以上操作无效，可在YAML文件顶部添加注释# yaml-language-server: $schema=https://azuredevops.azureedge.net/pipelines-schema/2024-05-01-preview.json，手动绑定最新官方Schema（注意替换为当前最新版本）。

关于扩展Bug的确认 #

这个问题在Azure Pipelines扩展的官方仓库有不少同类反馈，属于扩展Schema同步的偶发问题，微软会在后续版本修复。你可以查看扩展的Issues页确认是否有已提交的相同问题，或者提交新反馈帮助官方定位。

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