Azure DevOps YAML脚本任务名称匹配正常却报语法错误求助

• 需求：编写Azure DevOps CI/CD流水线YAML脚本，将本地PostgreSQL数据库的数据复制到Azure PostgreSQL实例
• 异常：脚本存在语法错误，且任务名称已匹配正确的情况下仍显示错误模式，需排查任务名称相关问题

1. 任务ID拼写错误
   Azure DevOps任务依赖固定ID（而非显示名称），比如官方PostgreSQL相关任务ID为PostgreSQLDeployment@1，需确保ID完全匹配官方定义，避免大小写、拼写偏差（如将PostgreSQL写成Postgres）。

2. 任务版本格式错误
   任务版本需紧跟在ID后，格式为@数字，不能写成@v1或遗漏版本号。正确示例：

   - task: PostgreSQLDeployment@1
   

3. YAML缩进不符合规范
   任务节点需正确嵌套在jobs→steps层级下，每层缩进保持一致（2或4个空格），缩进错误会导致流水线无法识别任务：
   错误示例：

   jobs:
     - job: CopyDB
       steps:
   - task: PostgreSQLDeployment@1  # 缩进不足，未对齐到steps层级
       inputs:
         connectionString: $(AzurePostgresConnStr)
   

4. 任务与输入参数位置混淆
   不能将任务ID写在inputs块内，否则会被识别为输入参数而非任务节点：
   错误示例：

   - task: AzureCLI@2
     inputs:
       task: PostgreSQLDeployment@1  # 错误位置
       scriptType: bash
   

5. 自定义任务的安装与ID匹配问题
   若使用自定义任务，需确保任务已正确安装到Azure DevOps组织中，且YAML中使用的ID与自定义任务的注册ID完全一致（包括大小写）。

6. 特殊字符未正确处理
   若任务名称包含空格等特殊字符，需用单引号或双引号包裹：

   - task: 'Custom PostgreSQL Sync Task@1'
   

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