PowerShell V5兼容环境下如何处理Git非仓库类错误

核心思路 #

PowerShell中外部命令的错误默认不会触发try/catch（即便设置$ErrorActionPreference = 'Stop'，也只能通过退出码判断失败，无法区分具体错误类型）。因此需要捕获Git命令的标准错误输出，通过匹配特定错误字符串实现精准处理，而非仅依赖退出码。

具体实现步骤 #

1. 捕获Git命令的输出与错误 #

将Git命令的stderr重定向到stdout（用2>&1），捕获所有输出后检查是否包含目标错误信息：

# 示例：执行git fetch并捕获输出
$gitOutput = git fetch 2>&1

if ($LASTEXITCODE -ne 0) {
    # 匹配"非Git仓库"错误的正则表达式
    $nonRepoPattern = 'fatal: not a git repository \(or any of the parent directories\): \.git'
    if ($gitOutput -match $nonRepoPattern) {
        Write-Error "错误：当前目录不是Git仓库，请先初始化或克隆BitBurner仓库。"
        # 自动修复：克隆BitBurner仓库到当前目录
        git clone https://github.com/danielyxie/bitburner.git .
        # 克隆完成后可重新执行后续操作
    } else {
        # 处理其他Git错误
        Write-Error "Git命令执行失败：$gitOutput"
        exit 1
    }
}

2. 封装成可复用函数（适合公开脚本） #

将Git命令执行与错误检查封装为函数，提升脚本可维护性：

function Invoke-GitCommand {
    param(
        [Parameter(Mandatory=$true)]
        [string]$Command,
        [string]$RepoPath = $PWD.Path
    )

    Push-Location $RepoPath
    try {
        $output = Invoke-Expression "git $Command" 2>&1
        if ($LASTEXITCODE -ne 0) {
            # 匹配非仓库错误
            if ($output -match 'fatal: not a git repository \(or any of the parent directories\): \.git') {
                throw [System.IO.DirectoryNotFoundException]::new("指定路径不是Git仓库：$RepoPath")
            }
            # 可扩展其他特定错误匹配，比如认证失败
            elseif ($output -match 'fatal: Authentication failed') {
                throw [System.UnauthorizedAccessException]::new("Git认证失败，请检查凭据。")
            }
            else {
                throw [System.Exception]::new("Git命令执行失败：`n$output")
            }
        }
        return $output
    }
    catch {
        throw
    }
    finally {
        Pop-Location
    }
}

3. 主脚本中调用函数并处理特定异常 #

通过try/catch捕获自定义抛出的异常，实现类原生异常的处理逻辑：

$bitBurnerPath = "C:\Path\To\BitBurner"

try {
    # 检查目标路径是否存在
    if (-not (Test-Path $bitBurnerPath)) {
        New-Item -ItemType Directory -Path $bitBurnerPath | Out-Null
        # 首次克隆仓库
        Invoke-GitCommand -Command "clone https://github.com/danielyxie/bitburner.git ." -RepoPath $bitBurnerPath
    }

    # 拉取远程最新提交
    Invoke-GitCommand -Command "fetch origin" -RepoPath $bitBurnerPath

    # 对比本地与远程提交哈希，判断是否有更新
    $localHead = git rev-parse HEAD 2>&1
    $remoteHead = git rev-parse origin/main 2>&1
    if ($localHead -ne $remoteHead) {
        Write-Host "检测到新提交，开始构建..."
        # 执行构建命令（根据BitBurner的实际构建流程调整）
        npm install --prefix $bitBurnerPath
        npm run build --prefix $bitBurnerPath
        Write-Host "构建完成！"
    } else {
        Write-Host "当前已是最新版本，无需构建。"
    }
}
catch [System.IO.DirectoryNotFoundException] {
    Write-Error $_.Exception.Message
    # 自动修复：重新克隆仓库
    Invoke-GitCommand -Command "clone https://github.com/danielyxie/bitburner.git $bitBurnerPath"
}
catch [System.UnauthorizedAccessException] {
    Write-Error $_.Exception.Message
    Write-Host "请运行以下命令配置Git凭据：`ngit config --global credential.helper manager-core"
    exit 1
}
catch {
    Write-Error "脚本执行失败：$($_.Exception.Message)"
    exit 1
}

关键细节说明 #

• 2>&1重定向：Git错误默认输出到stderr，重定向后可捕获错误文本进行精准匹配，解决仅靠退出码无法区分错误类型的问题。
• 正则转义：匹配错误字符串时需转义正则特殊字符（如括号()、点.），确保匹配准确。
• 异常类型选择：针对不同Git错误抛出对应.NET原生异常，让错误逻辑更贴合PowerShell开发习惯，便于其他开发者理解。
• 函数封装：分离Git命令逻辑后，主脚本更简洁，也便于后续扩展其他Git错误的处理规则。

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