Jenkins单引号脚本中变量无法渲染的问题

你的问题核心是单引号包裹的shell脚本无法读取withEnv设置的环境变量，同时要兼顾凭据安全不泄露。以下是具体解决方法：

1. 先修复代码语法错误 #

你的代码缺少两个闭合大括号，语法错误会导致withEnv逻辑不执行，直接造成环境变量失效。修正后的完整代码：

def my_func(String username) {
  withEnv(["user=abc"]) {
    sh(encoding:'UTF-8', script: '''
      #!/usr/bin/bash
      set +x -e
    
      echo "Username is $user"
    ''')
  }
}

2. 正确传递Jenkins变量到shell #

如果你需要将函数参数username传递给shell（而不是固定值abc），要通过withEnv用双引号注入环境变量（这一步安全，不会泄露凭据），然后在单引号脚本里直接用$user读取：

def my_func(String username) {
  withEnv(["user=${username}"]) {
    sh(encoding:'UTF-8', script: '''
      #!/usr/bin/bash
      set +x -e
    
      # 直接用$user读取环境变量，单引号脚本不会被Jenkins插值，避免凭据泄露
      echo "Username is $user"
    ''')
  }
}

关键原理说明 #

• Jenkins Pipeline中，三单引号包裹的脚本会原封不动传给shell执行，Jenkins不会做任何变量插值，因此脚本里的$user会由shell解析为环境变量，而非Jenkins变量。
• withEnv是将变量注入Jenkins运行环境，shell进程会自动继承这些环境变量，只要语法正确就能直接读取。
• 你之前尝试的转义\$user或嵌套引号都是错误操作：单引号里的转义字符会被shell当作普通字符，反而会阻止环境变量解析。

排查小技巧 #

如果还是无法读取变量，可以在shell脚本里添加env | grep user，查看环境变量是否被正确注入，确认withEnv逻辑是否生效。

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