如何解决Jenkins向PowerShell传递含单引号参数的未终止字符串错误？

核心问题原因 #

你遇到的是Shell命令行解析时的引号冲突：当参数里的单引号和包裹参数的单引号相遇，Shell会把中间的单引号当成引号对的结束，导致字符串未终止错误。下面是几种直接可行的解决办法，都不需要新增单独的格式化阶段：

方法1：转义参数中的单引号 #

PowerShell规定，单引号包裹的字符串中，内部的单引号需要用两个连续单引号来转义。在Jenkins Groovy里直接对参数做替换处理即可：

sh """pwsh -file script.ps1 '${params.NAME.replace("'", "''")}' '${params.DESCRIPTION.replace("'", "''")}' '${params.SOMETHING.replace("'", "''")}'"""

比如参数Somebody's description会被转成Somebody''s description，PowerShell执行时会正确识别为原字符串，不会中断引号对。

方法2：通过环境变量传递参数 #

把Jenkins参数导出为环境变量，让PowerShell直接读取环境变量，彻底避开命令行的引号解析问题：

1. 先在流水线块里定义环境变量：

environment {
    NAME = params.NAME
    DESCRIPTION = params.DESCRIPTION
    SOMETHING = params.SOMETHING
}

2. 然后调用PowerShell脚本：

sh '''pwsh -file script.ps1 "$env:NAME" "$env:DESCRIPTION" "$env:SOMETHING"'''

这里用Shell的单引号包裹整个pwsh命令，避免Shell解析PowerShell的双引号，PowerShell会直接读取环境变量的值，不管里面有没有单引号。

方法3：使用Jenkins原生pwsh步骤（推荐） #

Jenkins提供了专门的pwsh步骤（针对PowerShell Core），支持直接传递参数数组或命名参数，Jenkins会自动处理参数的转义和传递，完全不用手动处理引号：

方式A：传递位置参数 #

pwsh '''
& ./script.ps1 $args[0] $args[1] $args[2]
''', arguments: [params.NAME, params.DESCRIPTION, params.SOMETHING]

方式B：传递命名参数（更清晰） #

如果你的PowerShell脚本是用param()定义参数的，还可以直接传命名参数：

pwsh '''
param(
    [string]$Name,
    [string]$Description,
    [string]$Something
)
# 这里写你的脚本逻辑，直接用$Name、$Description、$Something即可
''', parameters: [
    Name: params.NAME,
    Description: params.DESCRIPTION,
    Something: params.SOMETHING
]

关于是否需要新增阶段 #

不需要额外新增格式化阶段，上面所有方法都可以在调用PowerShell的同一个阶段内完成。如果要做参数格式化，方法1的replace替换就是最直接的格式化操作，一行代码就能搞定。

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