Windows环境下Jenkins的WORKSPACE参数含空格时如何正确使用？

这个问题我之前帮人排查过，本质是路径包含空格导致的命令参数拆分错误——咱们一步步来解决：

问题根源 #

你的Jenkins工作目录路径C:\Program Files (x86)\Jenkins\workspace\jenkins-AutomationFreeStyle-Pipeline-2里有空格（Program Files部分），当你执行cp -a hpdevops-discovery-demoapp-master/. $WORKSPACE/时，bash会把空格当成参数分隔符，自动把路径拆成了三个部分：

• 'C:\Program'
• Files
• '(x86)\Jenkins\workspace\jenkins-AutomationFreeStyle-Pipeline-2/'

这就导致cp命令误以为你要把文件复制到多个目标，而非一个目录，所以抛出了target '(x86)\Jenkins\workspace\jenkins-AutomationFreeStyle-Pipeline-2/' is not a directory的错误。

解决方案 #

方案1：给WORKSPACE变量添加引号（最快修复） #

直接在命令中用双引号包裹$WORKSPACE，让bash把整个路径识别为单个参数：

cp -a hpdevops-discovery-demoapp-master/. "$WORKSPACE/"

双引号会保留变量内部的空格，避免被拆分，这是bash环境下处理含空格路径的标准做法。

方案2：改用Windows原生复制命令（如果用的是CMD环境） #

如果你在Jenkins中配置的是Windows命令提示符（而非Git Bash等bash环境），建议使用Windows原生的xcopy或robocopy命令，适配Windows路径规则：

xcopy /E /I hpdevops-discovery-demoapp-master\* "%WORKSPACE%"

• /E：复制所有子目录（包括空目录）
• /I：如果目标路径不存在，自动创建目录
• Windows环境变量用%变量名%包裹，天然支持含空格的路径

方案3：迁移Jenkins到无空格路径（根治问题） #

如果不想每次都处理路径转义，最彻底的方法是把Jenkins安装或迁移到没有空格的目录下，比如C:\Jenkins，这样后续所有涉及WORKSPACE的命令都不用再担心空格拆分问题。

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