PowerShell脚本报错显示随机字符，难以定位错误根源

常见原因及解决步骤 #

• 编码不兼容：脚本文件编码混乱（如UTF-8无BOM、GBK与UTF-8混编）会导致解析时出现乱码或随机字符
  • 处理：用PowerShell命令检查编码：Get-Content -Path "你的脚本路径.ps1" -Encoding Byte | Select-Object -First 3，若前三个字节为0xEF,0xBB,0xBF则是UTF-8带BOM格式；将脚本重新保存为UTF-8带BOM格式（PowerShell原生兼容该编码）
• 输出日志乱码：报错信息输出时编码不匹配引发显示异常
  • 处理：执行脚本时指定输出编码生成日志：powershell.exe -Command "& '你的脚本路径.ps1'" | Out-File -Path "报错日志.txt" -Encoding UTF8，用支持UTF-8的编辑器查看日志
• 隐藏不可见字符：复制粘贴脚本时带入零宽空格、控制字符等非打印字符
  • 处理：用VS Code等编辑器开启「显示控制字符」功能，定位删除异常字符；或用命令清理：Get-Content "你的脚本.ps1" | ForEach-Object { $_ -replace '[^\x20-\x7E]', '' } | Set-Content "清理后的脚本.ps1" -Encoding UTF8BOM
• 终端渲染问题：终端字体不支持部分字符，导致显示为随机符号
  • 处理：切换终端字体为Consolas、Fira Code等宽字体；或改用Windows Terminal替代默认PowerShell终端

快速定位错误位置的技巧 #

• 分段执行脚本：将脚本拆分为多个区块逐段运行，缩小错误范围
• 启用调试模式：执行脚本时添加调试参数跟踪流程：powershell.exe -NoProfile -ExecutionPolicy Bypass -File "你的脚本.ps1" -Debug
• 捕获完整异常：用try/catch块输出详细堆栈信息：

try {
    # 你的脚本代码
}
catch {
    Write-Host "完整错误信息："
    $_ | Format-List -Force
}

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