Graphics.DrawString中Process块失效及PowerShell管道输出异常问题

我来帮你搞定这个PowerShell函数的问题！你的两个问题其实是相关的，核心原因是没有正确利用PowerShell函数的Begin/Process/End块的执行逻辑，导致每次处理管道对象都重新创建了绘图资源，最后只保留了最后一次的结果。

问题根源分析 #

1. 管道只获取最后一个对象：你的原函数在Process块里每次都生成新的图片文件，每处理一个管道对象就会重新初始化图片资源，相当于每个对象都单独生成一张图，但最后只有最后一次的图片被保留（或者说每次都覆盖了之前的），而不是把所有对象整合到同一张图里。
2. Graphics.DrawString无法正常工作：同样是因为Process块里每次都重新创建Graphics对象，没有在同一个画布上持续绘制内容，导致前面的内容都被覆盖或丢失。

修复后的完整代码 #

下面是调整后的函数，我利用了Begin/Process/End块的分工，确保所有管道对象都绘制到同一张图片上：

function out {
    [cmdletbinding()]
    param(
        [parameter(
            Mandatory = $true,
            ValueFromPipeline = $true,
            ValueFromPipelineByPropertyName = $true
        )]
        [string[]] $n
    )

    # 初始化阶段：只执行一次，创建画布、绘图资源
    Begin {
        $dirname = (Get-Location).Path
        $filename = "$(Get-Date -f "yyyy-MM-dd--HH-mm-ss-tt")--image.png"
        $ImagePath = Join-Path -Path $dirname -ChildPath $filename

        # 自定义图片尺寸，可根据需求调整
        $canvasWidth = 1000
        $canvasHeight = 800
        $image = New-Object System.Drawing.Bitmap($canvasWidth, $canvasHeight)
        $graphics = [System.Drawing.Graphics]::FromImage($image)
        
        # 设置画布样式：白色背景、抗锯齿
        $graphics.Clear([System.Drawing.Color]::White)
        $graphics.TextRenderingHint = [System.Drawing.Text.TextRenderingHint]::AntiAliasGridFit

        # 设置字体和画笔
        $font = New-Object System.Drawing.Font("Consolas", 10)
        $textBrush = [System.Drawing.Brushes]::Black
        
        # 初始化绘制位置和行间距
        $currentY = 20
        $lineSpacing = $font.GetHeight($graphics) + 6
    }

    # 管道处理阶段：逐个处理每个管道对象，逐行绘制
    Process {
        foreach ($item in $n) {
            # 绘制当前内容到画布
            $graphics.DrawString($item, $font, $textBrush, 20, $currentY)
            
            # 更新下一行的Y坐标
            $currentY += $lineSpacing

            # 可选：检查是否超出画布高度，给出警告
            if ($currentY + $lineSpacing -gt $canvasHeight) {
                Write-Warning "内容已超出画布高度，后续内容将被截断！"
                break
            }
        }
    }

    # 收尾阶段：保存图片并释放所有资源（非常重要！）
    End {
        $image.Save($ImagePath)
        
        # 必须释放GDI+资源，否则图片文件会被锁定无法修改/删除
        $graphics.Dispose()
        $image.Dispose()
        $font.Dispose()
        
        Write-Host "图片已成功保存到：`n$ImagePath"
    }
}

关键调整说明 #

• Begin块：只在函数启动时执行一次，负责创建画布、绘图对象、字体等资源，确保所有管道对象都在同一张图上绘制。
• Process块：每收到一个管道对象就执行一次，把当前对象的内容逐行绘制到画布上，持续更新绘制位置。
• End块：所有管道对象处理完成后执行，负责保存图片并释放GDI+资源（这一步绝对不能少，否则图片文件会被PowerShell进程锁定）。

测试方法 #

你可以用下面的命令测试，把所有进程名绘制到图片里：

Get-Process | Select-Object -ExpandProperty Name | out

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