Azure DevOps运行时参数替换文件值的实现方法咨询

核心问题原因 #

FileTransform@1任务默认仅识别管道变量（系统变量、自定义变量、变量组变量），而你定义的parameters属于管道参数，不属于变量体系，所以任务无法自动用参数值替换json字段。

三种可行解决方案 #

方案一：将参数转为管道变量后使用FileTransform@1

先通过脚本把参数值赋值给管道变量，再让FileTransform任务读取这个变量完成替换：

parameters:
  - name: language
    default: 'klingon'
    type: string

steps:
  # 将参数值设置为管道变量
  - powershell: |
      Write-Host "##vso[task.setvariable variable=language]${{ parameters.language }}"
    displayName: '把参数转为管道变量'

  # 执行JSON文件替换
  - task: FileTransform@1
    inputs:
      folderPath: '$(System.DefaultWorkingDirectory)'
      fileType: 'json'
      targetFiles: '**/appsettings.json'

执行后，appsettings.json中的"language"字段会被替换为你运行管道时手动选择的参数值。

方案二：用PowerShell脚本直接修改JSON文件

跳过FileTransform任务，直接编写脚本读取参数值并更新json文件，更灵活：

parameters:
  - name: language
    default: 'klingon'
    type: string

steps:
  - powershell: |
      # 定位appsettings.json文件路径
      $jsonFile = Join-Path -Path $(System.DefaultWorkingDirectory) -ChildPath "appsettings.json"
      # 读取并转换JSON内容
      $jsonContent = Get-Content -Path $jsonFile -Raw | ConvertFrom-Json
      # 替换language字段值
      $jsonContent.language = "${{ parameters.language }}"
      # 写回JSON文件
      $jsonContent | ConvertTo-Json -Depth 10 | Set-Content -Path $jsonFile
    displayName: '直接更新appsettings.json'

方案三：改用管道变量替代参数（简化场景）

如果你的需求允许，直接定义管道变量替代参数：

1. 在管道的「变量」面板中添加language变量，设置默认值为klingon，并勾选「在运行时允许编辑」。
2. 移除yml中的parameters块，保留FileTransform@1任务即可，任务会自动读取这个变量完成替换。

总结 #

如果需要保留手动选择参数的交互性，优先选方案一或方案二；如果场景不需要参数的强类型校验，方案三更简洁。

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