为何ImageMagick无法接受-PointSize参数的默认值？

你遇到的核心问题是ImageMagick的命令行参数顺序要求：文本相关的属性参数（如-pointsize）必须放在label:参数之前，否则不会被应用到文本生成中。

你的代码中，通过$PSBoundParameters.Keys += ...把默认的PointSize加入到键集合，但$PSBoundParameters.Keys的顺序是原参数声明顺序加上追加的PointSize，导致-pointSize参数被放在label:$value之后，ImageMagick会忽略这个晚于label:的文本属性设置。而手动传入-PointSize时，该参数会被包含在原始的$PSBoundParameters.Keys中，位置在Value之前，所以参数顺序正确，设置生效。

解决方案 #

重构参数数组的构建逻辑，确保文本属性参数始终排在label:之前，不需要修改$PSBoundParameters，而是分阶段构建参数：

修改后的函数代码：

Function New-Image{
    param(
        [Parameter(Mandatory)]
        $Destination,
        
        [Parameter(ValueFromPipeline)]
        [string]$Value,

        [string]$Dimentions,
        [int]$PointSize = 500,
        [string]$Font,
        [string]$FontColour,
        [string]$BackgroundColor,
        [string]$BorderColor,
        [String]$BorderStroke
    )

    # 1. 构建文本属性参数（必须在label之前）
    $magickArgs = @()
    # 优先使用用户传入的PointSize，否则用默认值
    $magickArgs += '-pointsize', $PointSize
    if ($PSBoundParameters.ContainsKey('Font')) {
        $magickArgs += '-font', $Font
    }
    if ($PSBoundParameters.ContainsKey('BackgroundColor')) {
        $magickArgs += '-background', $BackgroundColor
    }
    if ($PSBoundParameters.ContainsKey('FontColour')) {
        $magickArgs += '-fill', $FontColour
    }

    # 2. 添加文本内容参数（label:必须在属性之后）
    $magickArgs += "label:$Value"

    # 3. 构建边框相关参数（在文本之后）
    if ($PSBoundParameters.ContainsKey('BorderColor')) {
        $magickArgs += '-bordercolor', $BorderColor
    }
    if ($PSBoundParameters.ContainsKey('BorderStroke')) {
        $magickArgs += '-border', $BorderStroke
    }

    $magickArgs
    . 'C:\Program Files\ImageMagick-7.1.0-Q16-HDRI\magick.exe' @magickArgs $Destination
}

关键说明 #

• 分三个阶段构建参数：先处理文本属性（-pointsize、-font等），然后是文本内容label:$Value，最后是边框参数，完全符合ImageMagick的参数顺序要求。
• 对于PointSize，直接使用变量值（不管是默认还是用户传入），不需要依赖$PSBoundParameters，彻底避免了键顺序的问题。
• 其他可选参数通过$PSBoundParameters.ContainsKey判断是否添加，保证只有用户传入的参数才会被传递给ImageMagick。

测试验证 #

执行New-Image "hello world" -Destination "test3.png"，此时-pointsize 500会排在label:hello world之前，生成的图片文本大小正常；手动传入-PointSize 300时，参数位置依然正确，设置生效。

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