如何将含特殊字符的Build.SourceVersionMessage写入Azure DevOps的NuGet.nuspec？

直接用PowerShell操作XML文档是最可靠的方案，能自动处理所有XML特殊字符（包括单双引号、<、>、&等）的转义，彻底避免字符串替换带来的格式错误。

具体实现脚本 #

# 定位nuspec文件路径，根据项目实际结构调整
$nuspecPath = "$(Build.SourcesDirectory)/YourProject/package.nuspec"

# 读取nuspec内容并转为XML对象
$xmlContent = Get-Content -Path $nuspecPath -Raw
$xml = [xml]$xmlContent

# 获取Azure DevOps中的版本消息变量
$releaseNotesContent = $env:BUILD_SOURCEVERSIONMESSAGE

# 定位releaseNotes节点并设置内容
$releaseNotesNode = $xml.SelectSingleNode("//package/metadata/releaseNotes")
if ($releaseNotesNode) {
    $releaseNotesNode.InnerText = $releaseNotesContent
} else {
    # 若节点不存在，创建并添加到metadata节点下
    $newReleaseNotesNode = $xml.CreateElement("releaseNotes")
    $newReleaseNotesNode.InnerText = $releaseNotesContent
    $xml.package.metadata.AppendChild($newReleaseNotesNode) | Out-Null
}

# 保存修改后的nuspec文件
$xml.Save($nuspecPath)

方案优势 #

通过XML对象的InnerText属性赋值时，.NET的XML解析器会自动完成所有特殊字符的转义：

• 双引号"转成"
• 单引号'转成'
• 小于号<转成<
• 大于号>转成>
• 和号&转成&

完全无需手动编写转义逻辑，不管版本消息包含什么字符，都能正确写入nuspec文件，不会出现字符串格式报错。

流水线使用注意事项 #

• 确保脚本中$nuspecPath的路径与项目中nuspec文件的实际位置匹配，可结合Azure DevOps预定义变量（如$(Build.SourcesDirectory)）定位文件
• 若使用Linux/macOS代理，需确保代理已安装PowerShell Core；Windows代理可直接运行脚本

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