Github Action(Windows)中Git获取Tag失败如何避免流程终止

针对Windows-2022环境下GitHub Action中PowerShell脚本里git describe无标签报错导致步骤终止的问题，给你三个可行方案：

方案1：临时调整错误处理偏好 #

GitHub Action默认把$ErrorActionPreference设为Stop，这会让外部命令（比如git）的非0退出码直接触发终止错误。你可以在执行git describe前后临时修改这个偏好，执行完再恢复：

# 保存原有设置
$originalErrorPref = $ErrorActionPreference
# 临时改为Continue，外部命令报错不会终止流程
$ErrorActionPreference = 'Continue'

# 执行git describe，把错误输出丢去null避免冗余日志
$latestTag = git describe --tags --abbrev=0 2>$null

# 恢复原有错误处理偏好
$ErrorActionPreference = $originalErrorPref

# 处理无标签的情况
if ($LASTEXITCODE -ne 0) {
    $latestTag = "v0.0.0" # 自定义默认标签
    Write-Host "未找到Git标签，使用默认值: $latestTag"
}

方案2：用CMD包装命令强制返回0 #

借助CMD的命令逻辑，让git describe失败时整个命令返回0，这样PowerShell不会判定为错误：

# 用cmd执行，失败时自动返回0
$latestTag = cmd /c "git describe --tags --abbrev=0 2>nul || exit 0"

# 空结果即无标签，设置默认值
if ([string]::IsNullOrWhiteSpace($latestTag)) {
    $latestTag = "v0.0.0"
    Write-Host "未找到Git标签，使用默认值: $latestTag"
}

方案3：在try/catch中正确捕获错误 #

如果一定要用try/catch，需要把git命令的错误转换成PowerShell可捕获的异常，方法是重定向错误流并加上-ErrorAction Stop：

try {
    # 将git的错误输出重定向到PowerShell错误流，并触发终止错误
    $latestTag = & git describe --tags --abbrev=0 2>&1 -ErrorAction Stop
}
catch {
    $latestTag = "v0.0.0"
    Write-Host "未找到Git标签，使用默认值: $latestTag"
}

额外注意 #

• git describe的参数可以按需调整：--tags会包含轻量标签，--abbrev=0只返回最近的标签名，如果你需要带提交哈希的格式可以去掉--abbrev=0。
• 在GitHub Action步骤里建议加上shell: pwsh，明确使用PowerShell Core，避免和Windows默认的PowerShell 5.x产生兼容问题。

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