Windows11 Git Bash仅在Git仓库显示分支名的配置问题

问题分析 #

你当前的核心问题是没有利用__git_ps1函数的自动判断特性——该函数仅在Git仓库目录下才会输出分支信息，否则返回空字符串。之前的写法直接固定了“on git”文本，导致非Git目录下也会显示该前缀。

解决方案 #

1. 定位并编辑git-prompt.sh文件 #

Git Bash的git-prompt.sh通常位于Git安装目录的mingw64/share/git-core/路径下，在Git Bash中可以用以下命令打开编辑：

notepad /mingw64/share/git-core/git-prompt.sh

2. 修改提示符配置 #

找到文件中设置PS1的部分，替换为以下代码（保留你已正常工作的虚拟环境逻辑，优化Git分支部分）：

# 自定义提示符核心配置
PS1='\u in \w\
$(__git_ps1 " on git(%s)")\
$(if [ -n "$VIRTUAL_ENV" ]; then echo " using ($(basename "$VIRTUAL_ENV"))"; fi)\
\$ '

3. 生效配置 #

保存文件后，重启Git Bash即可生效；或者执行以下命令让配置立即生效：

source /mingw64/share/git-core/git-prompt.sh

代码解释 #

• \u：显示当前登录用户名
• \w：显示当前工作目录的完整路径
• $(__git_ps1 " on git(%s)")：仅在Git仓库内才会输出 on git(分支名)格式的内容，非仓库目录下无任何输出
• $(if [ -n "$VIRTUAL_ENV" ]; then ... fi)：仅当虚拟环境激活时，才会输出 using (虚拟环境名)格式的内容
• \$：普通用户显示$，管理员用户显示#

验证效果 #

• 非Git仓库目录：username in /c/Users/xxx$
• Git仓库目录：username in /c/Projects/my-repo on git(main)$
• 激活虚拟环境的Git仓库目录：username in /c/Projects/my-repo on git(main) using (my-venv)$

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