一、为什么需要错误处理

写脚本就像开车，再熟练的司机也会遇到突发状况。PowerShell脚本运行时可能会遇到各种意外：文件找不到了、网络连接断了、权限不够了...如果不处理这些错误，脚本就会直接崩溃，就像开车突然熄火一样尴尬。

举个例子，你写了个自动备份脚本，结果因为一个临时文件被占用就直接罢工了，这显然不是我们想要的结果。好的错误处理能让脚本遇到问题时优雅地降级，至少能记录下问题出在哪，而不是直接撂挑子不干。

二、PowerShell的错误类型

PowerShell把错误分成两大类：终止错误和非终止错误。简单来说：

  • 非终止错误：就像开车时看到前方有坑，车子会颠一下但还能继续开
  • 终止错误：就像撞墙了，车子直接熄火

看个例子：

# 技术栈：PowerShell 7.x

# 非终止错误示例
Get-ChildItem "不存在的文件夹"  # 文件夹不存在，但脚本会继续执行

# 终止错误示例
Get-ChildItem "不存在的文件夹" -ErrorAction Stop  # 加了Stop参数，遇到错误直接停止

三、基础错误捕获方法

3.1 Try-Catch-Finally 结构

这是最常用的错误处理方式，和很多编程语言类似：

# 技术栈：PowerShell 7.x

try {
    # 尝试执行的代码
    $result = 1 / 0  # 这明显会出错
}
catch {
    # 出错时执行的代码
    Write-Host "出错啦！错误信息：$_" -ForegroundColor Red
}
finally {
    # 无论是否出错都会执行的代码
    Write-Host "清理工作完成" -ForegroundColor Green
}

3.2 错误变量 $Error

PowerShell会自动把错误记录在 $Error 变量中，这是个数组，最新的错误在最前面：

# 技术栈：PowerShell 7.x

Get-ChildItem "不存在的文件夹"  # 故意制造错误
$latestError = $Error[0]  # 获取最新错误
Write-Host "最近一次错误是：$latestError"

四、高级错误处理技巧

4.1 处理特定类型的错误

有时候我们需要针对不同类型的错误做不同处理：

# 技术栈：PowerShell 7.x

try {
    # 尝试读取文件
    Get-Content "不存在的文件.txt" -ErrorAction Stop
}
catch [System.IO.FileNotFoundException] {
    Write-Host "文件没找到，请检查路径" -ForegroundColor Yellow
}
catch [System.UnauthorizedAccessException] {
    Write-Host "没有权限访问这个文件" -ForegroundColor Red
}
catch {
    Write-Host "其他错误: $_" -ForegroundColor Red
}

4.2 自定义错误信息

我们可以抛出更友好的错误信息：

# 技术栈：PowerShell 7.x

function Test-Number {
    param (
        [int]$Number
    )
    
    if ($Number -gt 100) {
        throw "数字太大了，不能超过100"
    }
    
    "输入的数字是: $Number"
}

try {
    Test-Number -Number 150
}
catch {
    Write-Host "自定义错误: $_" -ForegroundColor Magenta
}

五、实战：完整的错误处理示例

来看一个结合文件处理和网络请求的实际例子：

# 技术栈：PowerShell 7.x

function Get-WebsiteContent {
    param (
        [string]$Url,
        [string]$OutputFile
    )
    
    try {
        Write-Host "开始获取网站内容..."
        
        # 检查输出路径是否合法
        if (-not (Test-Path (Split-Path $OutputFile -Parent))) {
            throw "输出路径不存在: $(Split-Path $OutputFile -Parent)"
        }
        
        # 尝试获取网页内容
        $response = Invoke-WebRequest -Uri $Url -ErrorAction Stop
        
        # 尝试写入文件
        try {
            $response.Content | Out-File -FilePath $OutputFile -ErrorAction Stop
            Write-Host "内容已成功保存到 $OutputFile" -ForegroundColor Green
        }
        catch {
            throw "写入文件时出错: $_"
        }
    }
    catch [System.Net.WebException] {
        Write-Host "网络请求失败: $($_.Exception.Message)" -ForegroundColor Red
        # 可以在这里添加重试逻辑
    }
    catch {
        Write-Host "处理过程中出错: $_" -ForegroundColor Red
        # 记录错误日志
        $_ | Out-File -FilePath "error.log" -Append
    }
    finally {
        Write-Host "操作完成，清理临时资源..." -ForegroundColor Cyan
        # 这里可以释放资源，比如关闭网络连接等
    }
}

# 使用示例
Get-WebsiteContent -Url "https://example.com" -OutputFile "example.html"

六、错误处理最佳实践

  1. 不要忽略所有错误：空catch块是万恶之源，至少记录下错误信息
  2. 合理使用ErrorAction：大多数cmdlet都有-ErrorAction参数，控制错误行为
  3. 记录详细的错误日志：包括时间、错误类型、堆栈信息等
  4. 考虑错误恢复：某些错误可以自动重试，比如网络请求
  5. 给用户友好的提示：技术细节记录到日志，给用户看易懂的信息

七、常见陷阱与解决方案

陷阱1：try块里的所有错误都会被捕获吗？ 不一定，有些错误需要设置-ErrorAction Stop才会被捕获

解决方案：

try {
    Get-ChildItem "不存在的文件夹" -ErrorAction Stop
}
catch {
    # 现在这个错误会被捕获了
}

陷阱2：错误处理本身出错怎么办？

try {
    # 主逻辑
}
catch {
    try {
        # 错误处理逻辑
        Write-Log $_.ToString()  # 假设这个方法可能也会出错
    }
    catch {
        # 错误处理的错误处理
        Write-Host "连错误处理都出错了: $_"
    }
}

八、总结与进阶建议

错误处理是脚本健壮性的关键。刚开始可以简单记录错误，随着脚本复杂度提高，需要更精细的错误分类和处理。

进阶学习建议：

  1. 了解 $ErrorView 变量控制错误显示方式
  2. 学习 trap 语句（较老的错误处理方式）
  3. 研究 -ErrorVariable 参数捕获错误到指定变量
  4. 探索 PowerShell 7 新增的 Get-Error cmdlet

记住：好的错误处理不是让脚本永远不出错，而是让脚本在出错时能优雅地应对，提供足够的信息帮你快速定位问题。