YAML管道如何更新键名含冒号的appsettings.json配置

FileTransform@1 任务做JSON配置替换时，默认将冒号(:)作为配置层级分隔符，直接定义"api:connection": "xyz"变量时，任务会将其解析为「查找api父节点下的connection子节点」，而非匹配键名本身包含冒号的平级配置项，因此替换失效。

通过自定义任务的层级分隔符，让冒号被识别为键名的普通字符即可，操作步骤如下：

1. 在FileTransform@1任务配置中，新增separator参数，将默认的冒号分隔符替换为不会出现在你配置键名中的字符（常用.、_等）
2. 流水线变量中直接定义带冒号的键名，无需额外转义

对应YAML示例如下：

# 流水线变量定义，键名直接写带冒号的原始配置键即可
variables:
  "api:connection": "对应环境的connection配置值"

# 文件转换任务配置
- task: FileTransform@1
  inputs:
    folderPath: '$(System.DefaultWorkingDirectory)/你的项目发布输出路径'
    fileType: 'json'
    targetFiles: 'appsettings.json'
    separator: '.' # 自定义层级分隔符为点，此时冒号不再作为分层标记

• 自定义分隔符必须确认不会出现在任何需要替换的JSON配置键名中，否则会出现错误拆分节点、替换失败的问题
• 不要在默认分隔符模式下尝试用反斜杠转义冒号、给变量名加多层引号，这类写法都不会改变任务把冒号识别为层级分隔符的逻辑，无法生效
• 多环境部署场景下，可以把api:connection的不同值定义在DEV/UAT/PROD对应部署阶段的阶段级变量中，任务会自动读取当前阶段的变量值完成替换，无需修改任务逻辑

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