如何在Windows系统的Bash终端中显示当前活跃Git分支？

核心报错原因 #

你遇到的语法错误和Git分支不显示的问题，是Windows和macOS跨平台配置bash的常见问题，主要由以下2个核心原因导致：

• Windows默认的CRLF换行符无法被bash识别，行尾残留的\r字符会导致bash解析配置时出现语法错位，就是你看到的unexpected token )报错
• Git分支获取函数的兼容性不足，以及部分终端环境下PS1的命令替换解析逻辑存在差异

修复步骤 #

1. 转换配置文件换行符 #

首先将~/.bashrc和~/.bash_profile的换行符从Windows的CRLF改为LF格式：

• 如果你用VSCode编辑，直接点击编辑器右下角的CRLF，切换为LF后保存即可
• 也可以通过dos2unix工具批量转换，执行命令：
  dos2unix ~/.bashrc ~/.bash_profile

2. 优化Git分支获取函数 #

替换你现有的git_branch函数为兼容性更高的写法，避免sed解析git branch输出的不稳定问题：

git_branch() {
  local branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
  if [ -n "$branch" ]; then
    echo "($branch)"
  fi
}

3. 优化PS1变量的命令替换逻辑 #

避免直接在PS1内嵌入单引号包裹的命令替换，改用PROMPT_COMMAND预先计算分支值，修改PS1的相关配置如下：

# 在PS1配置前加这一行
PROMPT_COMMAND='__current_git_branch=$(git_branch)'

# 原来的分支行替换成下面的写法，不需要单引号包裹
PS1+="\[${orange}\]${__current_git_branch} "

4. 确保bash_profile加载bashrc #

Windows下的Git Bash默认不会主动加载~/.bashrc，请检查你的~/.bash_profile中是否有以下内容，没有的话加上：

if [ -f ~/.bashrc ]; then
  source ~/.bashrc
fi

验证生效 #

修改完成后执行以下命令加载配置，验证是否正常：
source ~/.bashrc
如果仍有报错，可以执行bash -x ~/.bashrc查看具体报错的行数，定位剩余配置问题。

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