如何在Jenkinsfile中使用PowerShell创建的文件？

核心问题分析 #

你遇到的问题本质是相对路径歧义：PowerShell执行时的工作目录可能和Groovy后续执行的工作目录不一致，导致文件创建在非预期路径；同时原脚本的字符串拼接方式容易出现转义错误，进一步引发路径问题。

解决方案步骤 #

1. 修改PowerShell脚本，使用绝对路径创建文件

将文件路径绑定到Jenkins的env.WORKSPACE（工作空间绝对路径），避免相对路径的不确定性，同时优化字符串写法减少转义错误：

pwsh(returnStdout: true, script: """
  # 加载函数脚本（使用绝对路径）
  . "${env.WORKSPACE}/folder/functions.ps1"
  # 输出文件到Jenkins工作空间根目录（绝对路径），指定UTF-8编码避免乱码
  (Get-servers).keys | Out-File -FilePath "${env.WORKSPACE}/serversList.txt" -Encoding utf8
""")

2. 在Groovy中使用绝对路径访问文件

直接通过env.WORKSPACE拼接绝对路径读取文件，同时增加存在性校验：

// 构造文件绝对路径
def serverFilePath = "${env.WORKSPACE}/serversList.txt"
def serverFile = new File(serverFilePath)

// 检查文件是否存在并读取内容
if (serverFile.exists() && serverFile.size() > 0) {
  def serverContent = serverFile.text
  // 这里添加你的文件处理逻辑，比如打印内容或传递给后续步骤
  echo "服务器列表内容：\n${serverContent}"
} else {
  error "服务器列表文件不存在或为空，请检查PowerShell脚本执行情况"
}

3. 额外验证：确保PowerShell脚本执行成功

可以通过returnStatus参数捕获脚本执行状态，提前发现错误：

def pwshExitCode = pwsh(returnStatus: true, script: """
  . "${env.WORKSPACE}/folder/functions.ps1"
  (Get-servers).keys | Out-File -FilePath "${env.WORKSPACE}/serversList.txt" -Encoding utf8
""")

if (pwshExitCode != 0) {
  error "PowerShell脚本执行失败，退出码：${pwshExitCode}"
}

关键注意事项 #

• 始终使用绝对路径操作文件，避免Jenkins不同步骤间工作目录变化的影响。
• 给Out-File指定-Encoding utf8，避免Groovy读取时出现乱码（PowerShell默认编码为UTF-16）。
• 确认Get-servers函数能正常返回数据，否则文件会被创建但内容为空。

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