如何在YAML模板中声明环境？遇'unexpected value template'错误

错误原因 #

你遇到的「Unexpected value 'template' in yaml template」错误，本质是模板文件的语法结构不符合流水线工具（比如GitHub Actions、Azure DevOps）的规范：

• 多数流水线模板的根节点不允许出现template关键字（这个字段是用来引用模板的，只能在主流水线文件里用，不能写在被引用的模板本身里）
• 也可能是模板的顶级字段写错了位置，比如把属于job或step的内容放到了根节点

如何在YAML模板中声明环境 #

完全可以在模板里声明环境变量，分两种主流场景举例：

1. GitHub Actions 场景 #

模板文件（比如deploy-template.yml）可以直接用env字段定义环境变量，也能接收主流水线传入的参数：

name: 部署任务
env:
  # 模板内固定的全局环境变量
  DEFAULT_ENV: production
jobs:
  deploy:
    runs-on: ubuntu-latest
    env:
      # 基于传入参数的job级环境变量
      JOB_ENV: ${{ inputs.job-env }}
    steps:
      - name: 打印环境变量
        run: |
          echo "全局环境变量：$DEFAULT_ENV"
          echo "Job级环境变量：$JOB_ENV"

主流水线调用时传递参数：

jobs:
  调用部署模板:
    uses: ./.github/workflows/deploy-template.yml
    with:
      job-env: staging

2. Azure DevOps 场景 #

通过parameters接收主流水线的传入值，再赋值给环境变量，也能直接定义固定变量：

parameters:
  - name: targetEnv
    type: string
    default: production

variables:
  # 用传入参数赋值环境变量
  TARGET_ENV: ${{ parameters.targetEnv }}
  # 模板内固定的环境变量
  APP_NAME: my-app

steps:
  - script: echo $(TARGET_ENV) $(APP_NAME)
    displayName: 打印环境变量

主流水线调用模板并传参：

steps:
  - template: deploy-template.yml
    parameters:
      targetEnv: staging

错误修复要点 #

1. 检查模板文件的顶级字段，确保没有template关键字（这个是用来引用模板的，只能出现在主流水线里）
2. 对照你用的流水线工具规范，确认模板的合法顶级字段（比如GitHub Actions允许name/env/jobs；Azure DevOps允许parameters/variables/steps等）

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