Jenkins Pipeline sh命令莫名添加换行，单引号变量为空问题排查

我来帮你拆解这两个Jenkins Pipeline里的典型问题，咱们一步步排查解决：

一、单引号导致变量为空的原因 #

Jenkins Pipeline的Groovy语法里，单引号字符串是字面量，不会解析变量，只有双引号字符串才会做变量插值。举个直观的例子：

def myVar = "hello"
sh 'echo ${myVar}' // 执行的是echo ${myVar}，输出${myVar}（变量未解析）
sh "echo ${myVar}" // 执行的是echo hello，输出hello（变量正常解析）

所以如果你的命令需要用到变量，必须用双引号（""）或者三重双引号（""" """）包裹，单引号只适合完全不需要变量的固定命令。

二、自动添加换行符的可能原因及解决方法 #

换行符通常不是Jenkins自动加的，而是来自你的变量或者字符串写法，常见场景有这几种：

1. 变量本身包含换行符 #

如果你的变量是从文件读取、命令输出（比如sh returnStdout: true）或者用户输入来的，可能自带换行符。解决方法是用trim()去掉前后的空白字符（包括换行）：

// 比如从命令输出获取变量时，直接trim
def buildVersion = sh(script: "git describe --tags", returnStdout: true).trim()
// 或者对已有变量处理
def myVar = env.MY_PARAM ? env.MY_PARAM.trim() : ""

2. 多行字符串拼接带来的换行 #

如果你用三重双引号写多行命令，Groovy会保留换行和缩进，这可能导致命令被拆成多行执行（有时候是预期的，但如果不需要就会出问题）。如果要把多行写成一行，或者去掉不必要的换行，可以用stripIndent()方法：

// 错误示例：会保留换行和缩进，执行时是多行命令
sh """
  echo ${myVar}
  ls -l
"""

// 正确示例1：把命令写成一行，避免换行
sh "echo ${myVar} && ls -l"

// 正确示例2：用stripIndent去掉缩进换行，输出紧凑的命令
sh """
  echo ${myVar}
  ls -l
""".stripIndent()

3. 调试技巧：查看实际执行的命令 #

不确定哪里出问题时，可以在sh命令开头加set -x，Jenkins会输出实际执行的完整命令，帮你定位换行或变量替换的问题：

sh "set -x && echo ${myVar} && ls -l"

查看控制台日志，就能看到Jenkins到底执行了什么，是不是有多余的换行，变量有没有正确替换。

总结 #

• 变量为空：改用双引号/三重双引号包裹命令，让Groovy解析变量
• 自动换行：检查变量是否带换行（用trim()处理），调整字符串写法（一行命令或stripIndent()），用set -x调试实际执行的命令

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