如何在Jenkins中修改PWD环境变量以解决路径含空格报错问题

背景说明 #

默认Jenkins中PWD环境变量等于当前构建的WORKSPACE路径，当路径存在空格时会导致shell命令解析错误，以下为将路径空格段包裹双引号的具体实现方式。 #

方案1：当前shell步骤临时修改（推荐，无全局副作用） #

直接在shell执行步骤的开头添加以下命令即可，修改仅对当前步骤的后续命令生效：

export PWD="${PWD%/*}/\"${PWD##*/}\""

命令说明：

• ${PWD%/*} 提取最后一个斜杠之前的路径（即示例中的home/user）
• ${PWD##*/} 提取最后一个斜杠之后的带空格的目录名（即示例中的File Storage）
• 拼接后自动给带空格的目录名包裹双引号，符合你需要的home/user/"File Storage"格式

方案2：Freestyle项目全局生效 #

• 进入目标项目的「配置」页面
• 找到「构建环境」板块，勾选「Set environment variables (override build variables)」
• 在「Properties Content」输入框填入以下内容：

PWD=$(echo ${WORKSPACE} | sed 's#\(.*\)/\([^/]* [^/]*\)#\1/"\2"#')

• 保存配置后，所有构建步骤的PWD变量都会自动适配带引号的格式

方案3：Pipeline项目使用 #

声明式Pipeline建议单独定义修改后的路径变量，不推荐全局覆盖原生PWD避免插件运行异常，配置示例如下：

pipeline {
    agent any
    environment {
        // 生成带引号的路径变量
        QUOTED_PWD = sh(script: 'echo "${WORKSPACE%/*}/\\"${WORKSPACE##*/}\\""', returnStdout: true).trim()
    }
    stages {
        stage('执行构建逻辑') {
            steps {
                // 需要用到路径的地方引用$QUOTED_PWD即可
                sh 'your_command $QUOTED_PWD'
            }
        }
    }
}

验证方式 #

修改完成后在shell步骤中添加echo $PWD（或echo $QUOTED_PWD），输出为你预期的home/user/"File Storage"即为配置成功。

提示：如果路径存在多处空格，可调整sed规则为全局匹配带空格的路径段，逐个包裹双引号即可。
额外优化建议：如果仅需解决空格引发的命令报错，无需修改PWD本身，在所有引用$PWD的位置外层包裹双引号即可，比如cd "$PWD"，该方案兼容性更强，不会引发环境变量相关的异常问题。

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