如何在MSYS UCRT Bash中将当前Git分支添加到命令提示符

问题背景 #

我在Cygwin及多数类Unix系统中，一直用以下.bashrc配置生成带Git分支的彩色提示符：

parse_git_branch() {
    git branch 2> /dev/null | sed -e '/^[^*]/d' -e 's/* \(.*\)/ (\1)/'
}

PS1='${debian_chroot:+($debian_chroot)}\[\033[00;32m\]\u@\h\[\033[00m\] \[\033[00;33m\]\w\[\033[01;31m\]$(parse_git_branch)\[\033[00m\] \n\$ '

生成的提示符示例：

xxxx@LAPTOP /cygdrive/c/dev/some_git_repo (master)

但在MINGW64、MSYS、UCRT64中，parse_git_branch函数无法执行，无法显示分支信息。尝试修改PS1后还出现语法错误：

# PS1='\[\e]00;\w\a\]\n\[\e[00;32m\]\u@\h \[\e[00;35m\]$MSYSTEM\[\e[00m\]  \[\e[00;33m\]\w\[\e[01;31m\] $(parse_git_branch)\[\e[00m\] \n\$ '

# 错误信息：
# -bash: command substitution: line 1: syntax error near unexpected token `)'
# -bash: command substitution: line 1: `parse_git_branch)'

解决方案 #

方法1：修复命令替换的语法问题 #

MINGW系列环境中，单引号定义PS1时，命令替换的解析规则有差异，改用双引号定义PS1可确保函数正常执行：

parse_git_branch() {
    git branch 2> /dev/null | sed -e '/^[^*]/d' -e 's/* \(.*\)/ (\1)/'
}

# 双引号下变量与命令替换会被正确解析
PS1="${debian_chroot:+($debian_chroot)}\[\033[00;32m\]\u@\h\[\033[00m\] \[\033[00;33m\]\w\[\033[01;31m\]$(parse_git_branch)\[\033[00m\] \n\$ "

方法2：使用Git内置命令提升效率 #

Git自带git symbolic-ref可直接获取当前分支，比git branch加sed更高效，适配性更强：

parse_git_branch() {
    local branch=$(git symbolic-ref --short HEAD 2> /dev/null)
    [ -n "$branch" ] && echo " ($branch)"
}

PS1="${debian_chroot:+($debian_chroot)}\[\033[00;32m\]\u@\h\[\033[00m\] \[\033[00;33m\]\w\[\033[01;31m\]$(parse_git_branch)\[\033[00m\] \n\$ "

方法3：适配MINGW环境变量（显示MSYSTEM） #

如果需要显示当前MINGW环境标识（如MINGW64/UCRT64），可将$MSYSTEM加入PS1：

parse_git_branch() {
    git symbolic-ref --short HEAD 2> /dev/null | awk '{print " ("$0")"}'
}

PS1="\[\e]0;\w\a\]\n\[\e[00;32m\]\u@\h \[\e[00;35m\]$MSYSTEM\[\e[00m\]  \[\e[00;33m\]\w\[\e[01;31m\]$(parse_git_branch)\[\e[00m\] \n\$ "

生效验证 #

修改.bashrc后，执行以下命令使配置立即生效：

source ~/.bashrc

进入任意Git仓库，即可看到提示符中显示当前分支名称。

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