如何在Jenkins中向含&的批处理文件传递目录路径参数

问题分析 #

核心问题有两点：一是批处理文件名包含&特殊字符，需在bat语法中正确转义；二是路径参数的Groovy变量插值和引号嵌套处理不当，导致参数传递失败或语法错误。

修正方案 #

方案1：使用script和args参数分离写法

environment {
    ROOT_DIR = 'http:\\myserver.mycity.mycompany.com\\svn\\PRODUCT\\trunk'
}
...
stage('Copy my files') {
    steps {
        // 单引号包裹批处理路径，避免Groovy解析转义符；bat中用^&转义&
        bat script: 'ABC_123\\Rock^&Roll42.bat', 
            args: "\"${env.ROOT_DIR.trim()}\"" // 双引号插值变量，trim()去除多余空格
    }
}

方案2：合并脚本与参数为单个字符串（更直观）

environment {
    ROOT_DIR = 'http:\\myserver.mycity.mycompany.com\\svn\\PRODUCT\\trunk'
}
...
stage('Copy my files') {
    steps {
        bat "ABC_123\\Rock^&Roll42.bat \"${env.ROOT_DIR.trim()}\""
    }
}

关键说明 #

1. 批处理文件名转义：&在bat中是命令分隔符，必须用^&转义才能正确识别为文件名的一部分；Groovy用单引号包裹路径时，内容会原封不动传给bat，无需额外处理^。
2. 变量插值与引号嵌套：
   • 必须用双引号包裹包含${env.ROOT_DIR}的字符串，让Groovy正确替换变量值，而非传递字面量${env.ROOT_DIR}。
   • 给路径参数套上\"（Groovy双引号内的双引号需转义），确保bat将整个路径视为单个参数，避免反斜杠等特殊字符导致参数拆分。
3. 去除多余空格：trim()避免env.ROOT_DIR变量前后的空格导致路径无效。

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