如何解决ARM模板部署路径含空格导致的部署失败问题？

核心原因 #

%20是URL编码格式，不适用于本地文件路径的空格处理。命令行/Shell会把%20当作路径的一部分，而非空格的替代，所以会导致找不到目标文件。

可行解决方案 #

1. 用双引号完整包裹路径参数

在执行az bicep build命令时，将整个路径用双引号括起来，确保Shell将其识别为单个参数：

az bicep build --file "$(System.DefaultWorkingDirectory)/_Build Azure Function artefact/deploy/main.bicep"

在Azure DevOps命令行任务中直接这样编写即可，变量展开后引号会保留，避免空格拆分参数。

2. 借助PowerShell处理路径（推荐）

如果使用PowerShell任务执行命令，PowerShell会自动处理带空格的路径，无需额外转义：

$bicepFilePath = "$(System.DefaultWorkingDirectory)/_Build Azure Function artefact/deploy/main.bicep"
az bicep build --file $bicepFilePath

也可以用Join-Path拼接路径，进一步规避格式问题：

$baseDir = "$(System.DefaultWorkingDirectory)/_Build Azure Function artefact"
$bicepFilePath = Join-Path -Path $baseDir -ChildPath "deploy/main.bicep"
az bicep build --file $bicepFilePath

3. 修改工件名称（从根源避免）

直接将带空格的工件名称_Build Azure Function artefact修改为无空格的名称（比如_BuildAzureFunctionArtefact），这样生成的路径自然没有空格，后续所有操作都不会再遇到此类问题：

• 在前序构建流水线中，修改工件发布的名称；
• 更新发布流水线中的路径引用为新的无空格路径。

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