PowerShell 错误处理：try-catch-finally

编写 PowerShell 脚本时，遇到错误是家常便饭。如果不加处理，脚本一旦出错就会直接崩溃，不仅中断后续操作，还可能留下难以排查的烂摊子。使用 try-catch-finally 结构，可以让你掌控脚本的运行逻辑，决定出错后是继续执行、记录日志还是自动回滚。

理解核心逻辑：代码执行流程

在写代码之前，先理解 try-catch-finally 的运作顺序。这就像是你安排了一份“容错工作流”。

1. Try：尝试执行代码。如果一切顺利，跳过 Catch 直接去 Finally。
2. Catch：如果 Try 里面出了错（且是“终止错误”），立即跳到这里执行补救措施。
3. Finally：无论出没出错，这里最后一定会执行。通常用于关闭连接、释放文件或清理临时变量。

第一步：编写最基础的错误捕获结构

PowerShell 的默认行为比较特殊，它通常只显示红字错误但继续运行（非终止错误）。要让 try-catch 生效，必须强制将错误转变为“终止错误”。最关键的操作是添加 -ErrorAction Stop 参数。

打开 PowerShell ISE 或 VS Code，输入以下代码并运行：

try {
    # 尝试读取一个根本不存在的文件
    # 注意：这里必须加上 -ErrorAction Stop，否则 Catch 捕获不到
    Get-Content "C:\不存在的文件夹\假文件.txt" -ErrorAction Stop
    Write-Host "文件读取成功" -ForegroundColor Green
}
catch {
    # 如果上面的命令出错了，就会执行这里
    Write-Host "哎呀，出错了！" -ForegroundColor Red
    Write-Host "错误信息是：$($_.Exception.Message)" -ForegroundColor Yellow
}
finally {
    Write-Host "这段话不管出没出错，你都会看到。" -ForegroundColor Cyan
}

观察输出结果，你会发现即使文件不存在，脚本也没有崩溃，而是优雅地显示了你自定义的错误信息。

第二步：精准捕获特定错误

有时候，你不希望捕获所有错误，只想处理某一种特定情况（比如文件没找到），而把其他情况（比如权限不足）抛出来。这就需要指定捕获的错误类型。

修改上述代码中的 catch 部分：

try {
    Get-Content "C:\不存在的文件夹\假文件.txt" -ErrorAction Stop
}
catch [System.Management.Automation.ItemNotFoundException] {
    # 只有当错误类型是“找不到项目”时，才执行这里
    Write-Host "捕获到特定错误：文件或文件夹不存在。" -ForegroundColor Red
}
catch {
    # 如果是其他类型的错误，由这个通用的 Catch 接住
    Write-Host "捕获到未预料到的错误：$($_.Exception.Message)" -ForegroundColor Red
    # 这里可以重新抛出错误，让脚本停止
    throw
}
finally {
    Write-Host "检查结束。"
}

在这个例子中，catch [System.Management.Automation.ItemNotFoundException] 就像是一个专门负责“找文件”的保安，只有遇到“找不到”的情况它才出手，其他乱七八糟的错误它不管。

第三步：常见错误类型速查表

为了在 catch 后填入正确的类型，你需要知道错误的具体名称。下表列出了 PowerShell 中最常见的几种异常类型。

获取错误类型的方法：如果在脚本运行中看到了红字报错，可以执行 `$Error[0].Exception.GetType().FullName` 来查看最后一次错误的具体类型名称。 --- ### 第四步：实战演练——文件备份与清理 现在把学到的知识结合起来，写一个实用的脚本。这个脚本的任务是**复制**一个大文件到备份目录，如果中间出错，必须**删除**残缺的备份文件，防止占用空间。 **新建**一个脚本文件，**粘贴**以下代码： ```powershell # 定义源文件和目标路径 $sourceFile = "C:\Logs\huge_log.txt"
$backupPath = "D:\Backup\huge_log.txt" try { Write-Host "开始备份文件..." -ForegroundColor Cyan # 尝试复制文件 Copy-Item -Path $sourceFile -Destination $backupPath -ErrorAction Stop Write-Host "备份成功！" -ForegroundColor Green # 模拟一个验证步骤：如果备份文件小于 1KB，视为失败 $backupItem = Get-Item $backupPath if ($backupItem.Length -lt 1KB) {

主动抛出错误

    throw "备份文件损坏：文件大小异常。"
}

}
catch {
Write-Host "备份过程中发生错误：$($_.Exception.Message)" -ForegroundColor Red

# 清理逻辑：如果目标位置已经生成了残缺文件，删掉它
if (Test-Path $backupPath) {
        Write-Host "正在清理残缺的备份文件..." -ForegroundColor Yellow
        Remove-Item $backupPath -Force
}

# 可以在这里写入 Windows 事件日志或发送邮件
# Write-EventLog ...

}
finally {

无论成功失败，都记录一条操作日志

$logTime = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
    $status = if ($? -eq $true) { "成功" } else { "失败" }
Write-Host "[$logTime] 任务状态：$status"

}

在这个脚本中，我们**使用** `try` 块来执行核心的复制和验证操作。一旦发现文件大小异常，我们通过 `throw` 关键字**手动制造**一个错误，强制跳入 `catch` 块。在 `catch` 块中，我们**判断**并**删除**了可能导致问题的残缺文件。最后的 `finally` 块确保了无论结果如何，都会留下一条时间戳记录。

---

### 第五步：使用 `trap` 处理全局错误（进阶）

除了 `try-catch`，PowerShell 还提供了一个古老的 `trap` 关键字。它像是一张铺在脚本底下的网，能接住该作用域内任何未处理的错误。虽然现代脚本推荐用 `try-catch`，但在某些老脚本维护中可能会看到。

**理解**下面的代码：

```powershell
trap {
    Write-Host "Trap 捕获到了错误：$($_.Exception.Message)"
    # 继续执行下一行代码，而不是彻底停止
    continue
}

function Test-Trap {
    # 这里会出错，因为没有加 -ErrorAction Stop，所以是非终止错误
    # 但 Trap 会拦截
    Get-ChildItem "C:\不存在的路径" 

    Write-Host "函数继续运行..."
}

Test-Trap

在大多数情况下，优先使用 try-catch，因为它的作用域更清晰，不会像 trap 那样因为全局拦截而导致错误难以定位。

核心要点总结

1. 强制终止：永远记得在可能出错的命令后加上 -ErrorAction Stop，这是 catch 生效的前提。
2. **变量 $_`**：在 `catch` 块中，`$_ 代表当前的错误对象，通过 $_.Exception.Message 获取人类可读的描述。
3. 善用 finally：涉及文件操作、数据库连接或 COM 对象调用时，一定要在 finally 中释放资源或关闭连接，防止内存泄漏或文件被锁定。