Azure DevOps中replacetokens@5任务无法替换变量的问题排查

核心问题1：YAML缩进错误导致变量未被正确识别 #

你提供的流水线变量定义存在缩进错误，YAML对缩进层级有严格要求，当前value的缩进比name多一级，导致该变量未被流水线正确加载。replacetokens任务无法找到对应的REPLACE变量值，因此执行0次替换。

修正后的变量定义：

variables:
  - name: REPLACE
    value: 'XYZ'

核心问题2：keepToken配置的影响 #

你的任务配置中设置了keepToken: true，该参数的作用是当找不到令牌对应的变量值时，保留原令牌而不替换。结合变量未被正确加载的情况，任务会跳过替换操作，且不会触发actionOnMissing: fail（因为变量未被定义，任务未将其识别为"缺失的变量"，而是直接判定无对应值）。

如果需要确保变量存在时强制替换，建议将keepToken改为false：

keepToken: false

其他排查方向 #

• 确认变量作用域：如果变量是在阶段或作业级别定义，确保replacetokens任务所在的作业能访问到该变量。
• 检查令牌格式：确认文件中的令牌${REPLACE}没有多余的空格或特殊字符，与任务配置的tokenPrefix和tokenSuffix完全匹配。
• 查看详细日志：任务配置了verbosity: 'detailed'，可以查看任务执行日志中是否有"Found variable"相关的输出，确认变量是否被任务正确读取。

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