如何在启动Azure DevOps管道时配置变量输入提示？YAML管道手动启动版本号输入项不显示问题排查

一、如何配置管道启动时提示用户输入变量 #

要让Azure DevOps管道在手动启动时弹出变量输入框，核心是给目标变量添加prompt: true属性，同时可以搭配额外配置优化用户体验：

• 必须添加prompt: true：标记该变量为需要用户手动输入的参数
• 可选defaultValue：设置变量的默认值，用户可选择直接使用或修改
• 可选description：给用户明确的输入指引，比如变量的格式、用途

二、修复你当前的变量不显示问题 #

你现在的YAML写法只是定义了一个静态空变量，所以启动界面不会出现输入提示。问题出在没有添加prompt: true属性，且错误使用了value字段——当用value定义变量时，它会被视为静态固定值，不会触发输入提示逻辑。

正确的YAML写法 #

把你的变量定义改成这样：

variables:
  - name: versionName
    prompt: true
    defaultValue: '1.0.0' # 可选，设置一个合理的默认版本号
    description: '请输入本次构建/发布的版本号，格式示例：1.2.3或2.0.0-beta'

为什么之前的写法无效？ #

你原来的代码：

variables:
  - name: versionName
    value: ''

这种定义方式是创建一个静态变量，管道启动时会直接使用这个空值，不会向用户请求输入。只有当变量包含prompt: true属性时，Azure DevOps才会在手动启动界面展示该变量的输入框。

额外注意事项 #

• 如果变量是在模板中定义的，确保主管道正确引用了该模板，模板中的prompt属性会被继承到主管道中
• 变量名称要避免和Azure DevOps内置变量冲突，比如不要用Build.Version这类已有系统变量名

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