__git_ps1是Git官方维护的轻量函数，仅读取.git/HEAD等必要文件，避免实时调用完整Git命令导致卡顿；bash需加载git-prompt.sh并设GIT_PS1_SHOWCOLORHINTS=true，zsh应使用vcs_info模块而非硬套bash方案。
git branch --show-current 不能直接用于 PS1 渲染
很多人第一反应是把 git branch --show-current 塞进 PS1，比如写成 PS1='\u@\h:\w $(git branch --show-current)\$ '。这会导致每次显示提示符都执行一次 Git 命令，尤其在大仓库或 NFS 挂载目录下，延迟明显（常卡顿 0.3–1 秒）。
真正可用的方案必须避免实时调用完整 Git 命令：__git_ps1 是唯一被 Git 官方维护、专为 prompt 设计的轻量函数，它只读 .git/HEAD 和必要 ref 文件，不触发 index 扫描或远程检查。
bash 下启用 __git_ps1 高亮分支名的最小配置
确保你已加载 Git 补全脚本（否则 __git_ps1 不可用）：
在 ~/.bashrc 末尾添加：
source /usr/share/bash-completion/completions/git-prompt.sh GIT_PS1_SHOWCOLORHINTS=true PS1='[\u@\h \W$(__git_ps1 " (\033[32m%s\033[m)")]\$ '
-
/usr/share/bash-completion/completions/git-prompt.sh路径需按系统调整：macOS Homebrew 安装 Git 通常是/usr/local/share/bash-completion/completions/git-prompt.sh -
GIT_PS1_SHOWCOLORHINTS=true启用颜色支持，否则\033[32m不生效 - 绿色仅作用于分支名本身，括号和空格保持默认色，避免整段 prompt 变绿
- 不要加
$(git status --porcelain)类逻辑——那是git-aware-prompt的做法，会显著拖慢 prompt
zsh 用户别硬套 bash 的 __git_ps1
zsh 的 __git_ps1 行为与 bash 不一致，且部分版本存在兼容问题。更稳妥的做法是用 zsh 原生语法 + 简单 Git 调用：
autoload -Uz vcs_info
zstyle ':vcs_info:git:*' formats ' (%s)-%b'
zstyle ':vcs_info:git:*' actionformats ' (%s)-%b|%a'
precmd() { vcs_info }
PS1='%n@%m:%~${vcs_info_msg_0_}%# '-
vcs_info是 zsh 内置模块，比反复调用git命令更高效 -
%b是当前分支名，%s是 VCS 类型（如 git），%a是当前动作（rebase/cherry-pick 等） - 若需着色，改用
zstyle ':vcs_info:git:*' formats ' (%F{green}%b%f)'，%F{green}是 zsh 颜色语法 - 不要在
PS1里直接写$(git symbolic-ref --short HEAD 2>/dev/null)—— 错误时输出为空，导致 prompt 缺失括号，视觉断裂
补全和高亮共存时卡顿的根因与开关
即使用了 __git_ps1，你仍可能发现输入命令后 prompt 渲染变慢。这不是高亮的问题，而是补全脚本在后台偷偷干的事：
-
__git_ps1默认开启远程状态检查（是否 ahead/behind），每秒触发一次git rev-list查询，大仓库下耗时严重 - 解决方法：运行
git config --global bash.showUpstream "no"，彻底禁用 upstream 检查 - 如果还卡，检查是否启用了
GIT_PS1_SHOWDIRTYSTATE=true—— 它依赖git status --porcelain，同样慢；真需要脏状态，用vcs_info的check-for-changes样式更轻量 - 补全脚本自身扫描所有 ref（含远程分支）也会拖慢 Tab 补全：设
git config --global completion.branches false关闭远程分支补全，仅保留本地分支
最易被忽略的是：__git_ps1 和补全脚本必须来自同一份 Git 安装，混用不同版本（比如系统 Git + Homebrew Git）会导致函数未定义或行为异常。
