在 Shell 提示符中显示 Git 分支名称的方法

Git 的好处之一就是把代码的分支管理变成了一件极其便捷的事情，分支只保留差异，不用复制任何文件，不用连接网络，快速创建，用完即删。Git 分支与项目的复杂程度无关，不管你的项目多么复杂，创建 Git 分支永远都是瞬间的事情。同时，因为保留了父类分支的信息，所以分支的合并也变得异常简单。

当在一个项目中频繁使用多个分支时，可以使用 git status 命令查询自己现在正工作在哪个分支下面，不过难免有脑子发昏的时候，忘记自己在哪个分支下面，因而发生误操作之类的杯具。

那么把分支显示在 Shell 提示符中无疑方便了很多，再也不需要频繁的使用 git status 命令了…

实现原理很简单，大体就是查询当前目录下面的 Git 分支名称，然后嵌入到 PS1 变量中。那么，Git 分支名称可以通过下面的脚本轻松的获得：

git branch --no-color 2> /dev/null | sed -e '/^[^*]/d' -e 's/* (.*)/(1)/'

好在，可以使用另外一种方式来获取 Git 分支名称，在每个 Git 项目中，都有一个 .git 目录，这个目录下面有个叫做 HEAD 的文件，里面包含的当前分支的路径信息：

ref: refs/heads/BRANCH-NAME

我们只要读取这个文件，然后再和对应的路径互相匹配一下就知道正确地分支名称了。不要只是简单的从 HEAD 内容中拆分出最后的 BRANCH-NAME，因为它不一定是正确地。

以下是 Aaron Crane 的实现方式：

## Parses out the branch name from .git/HEAD:

find_git_branch () {

    local dir=. head

    until [ "$dir" -ef / ]; do

        if [ -f "$dir/.git/HEAD" ]; then

            head=$(< "$dir/.git/HEAD")

            if [[ $head = ref: refs/heads/* ]]; then

                git_branch=" → ${head#*/*/}"

            elif [[ $head != '' ]]; then

                git_branch=" → (detached)"

            else

                git_branch=" → (unknow)"

            fi

            return

        fi

        dir="../$dir"

    done

    git_branch=''

}

PROMPT_COMMAND="find_git_branch; $PROMPT_COMMAND"

最后只要重新定义 PS1 变量即可：

# Here is bash color codes you can use

  black=$'[e[1;30m]'

    red=$'[e[1;31m]'

  green=$'[e[1;32m]'

 yellow=$'[e[1;33m]'

   blue=$'[e[1;34m]'

magenta=$'[e[1;35m]'

   cyan=$'[e[1;36m]'

  white=$'[e[1;37m]'

 normal=$'[e[m]'

PS1="$white[$magentau$white@$greenh$white:$cyanw$yellow$git_branch$white]$ $normal"

最终效果如下：

UPDATE ? 2010/06/23:

如果你安装了随 Git 附送的 git-completion.sh 子命令自动完成脚本，也可以使用该脚本提供的方法：

export PS1="[u@h W"'$(__git_ps1 " (%s)")'"]$ "