如何无警告检出origin分支？Git子模块PowerShell脚本优化

我编写了一段PowerShell脚本用于获取Git子模块并设置其分支，该脚本将在流水线中运行，分支名由启动表单输入传入。脚本代码如下：

Param(
    [Parameter(Mandatory=$false)]
    [string]$branch = ""
)

cd "$PSScriptRoot\.."

git submodule update --init --recursive

Write-Host "Got branch $branch"

if (-not [string]::IsNullOrWhiteSpace($branch)) {
    cd "submodule"

    git checkout "origin/$branch"
    Write-Host "Installed branch $branch"
} else {
    Write-Host "Installed default branch"
}

目前使用git checkout "origin/$branch"可实现需求，但会出现警告，请问是否有更规范的实现方式？

规范实现方案 #

你遇到的警告源于直接checkout远程分支引用（origin/$branch）会让子模块进入**分离头指针（detached HEAD）**状态，Git会提示这种状态下的提交无法直接推送到远程分支，在流水线场景下可能引发后续问题。以下是两种更规范的实现方式：

方式一：创建并切换到跟踪远程分支的本地分支 #

如果子模块中尚未存在对应本地分支，建议先基于远程分支创建本地分支并设置跟踪关系，贴合Git常规工作流：

Param(
    [Parameter(Mandatory=$false)]
    [string]$branch = ""
)

$rootDir = Join-Path -Path $PSScriptRoot -ChildPath ".."
Set-Location -Path $rootDir

# 初始化并更新子模块
git submodule update --init --recursive

Write-Host "Got branch $branch"

if (-not [string]::IsNullOrWhiteSpace($branch)) {
    $submoduleDir = Join-Path -Path $rootDir -ChildPath "submodule"
    Set-Location -Path $submoduleDir

    # 拉取最新远程分支信息
    git fetch origin

    # 检查本地分支是否存在，存在则切换并拉取最新代码，不存在则创建跟踪分支
    if (git show-ref --verify --quiet "refs/heads/$branch") {
        git checkout $branch
        git pull origin $branch
    } else {
        git checkout -b $branch --track "origin/$branch"
    }

    Write-Host "Switched to branch $branch (tracking origin/$branch)"
} else {
    Write-Host "Installed default branch"
}

方式二：直接切换到远程分支并设置跟踪（适用于临时场景） #

如果不需要保留本地分支，仅需临时切换到远程分支最新状态，可使用Git 2.23+新增的git switch命令直接切换并建立跟踪，避免分离头指针状态：

Param(
    [Parameter(Mandatory=$false)]
    [string]$branch = ""
)

$rootDir = Join-Path -Path $PSScriptRoot -ChildPath ".."
Set-Location -Path $rootDir

git submodule update --init --recursive

Write-Host "Got branch $branch"

if (-not [string]::IsNullOrWhiteSpace($branch)) {
    $submoduleDir = Join-Path -Path $rootDir -ChildPath "submodule"
    Set-Location -Path $submoduleDir

    git fetch origin
    # 直接切换到远程分支并建立跟踪关系
    git switch --track "origin/$branch"

    Write-Host "Switched to branch $branch (tracking origin/$branch)"
} else {
    Write-Host "Installed default branch"
}

关键改进点说明 #

• 替换cd为Set-Location：PowerShell原生命令，语义更清晰规范。
• 增加git fetch origin：确保获取远程分支的最新状态，避免切换到过时提交。
• 消除分离头指针：通过创建本地分支或使用git switch --track，让子模块处于正常分支跟踪状态，解决Git警告问题。
• 分支存在性检查：提前判断本地分支是否存在，避免重复创建分支的错误。

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