Azure DevOps YAML流水线运行时变量如何添加提示/说明？

1. 通过YAML直接定义变量描述 #

在流水线YAML中给变量添加description字段，这是最直接的方式，设置后在运行流水线的变量面板里，鼠标悬停到变量名或输入框上会自动弹出提示文本。示例代码：

variables:
- name: PLUGIN_VERSION
  value: '1.0.0'
  description: '请输入插件版本号，格式为x.y.z，例如2.1.3'
- name: WORKITEM_ID
  value: ''
  description: '填写关联的Azure DevOps工作项ID，用于追踪流水线对应的任务'

2. 变量组中配置变量描述 #

如果你的变量来自变量组，可在变量组内为变量添加描述：

• 进入Azure DevOps的「库」→「变量组」
• 选中目标变量组，点击变量右侧的编辑图标
• 在编辑弹窗中填写「描述」字段并保存
• 当流水线引用该变量组后，运行面板里的对应变量会自动显示悬停提示。

3. UI补充说明（临时替代方案） #

如果需要更显眼的提示，可在流水线的说明区域添加变量指引：

• 编辑流水线YAML，在顶部添加全局描述：

description: |
  运行流水线时请按要求填写变量：
  - *PLUGIN_VERSION*：插件版本，需遵循x.y.z格式
  - *WORKITEM_ID*：关联的工作项唯一ID

也可以直接在流水线的概述页面，手动编辑「说明」内容，把变量的使用规则写进去，用户点击运行前可提前查看。

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