git分支补全依赖shell补全机制及git自带脚本，需手动加载；当前分支高亮靠ps1自定义或__git_ps1函数实现，二者共存时可能因远程检查或ref扫描导致卡顿，应针对性优化。
Git 命令行补全分支名不是靠 git checkout 自带的，而是依赖 shell 的补全机制（bash/zsh）和 Git 自带的补全脚本；当前分支高亮也不是终端原生功能，得靠 prompt 主题或自定义 PS1 实现。
Git 分支补全为什么默认不生效？
Git 安装包自带补全脚本（git-completion.bash 或 git-completion.zsh），但多数系统不会自动加载它。你执行 git checkout <tab></tab> 没反应，大概率是脚本没 source 进来。
- Linux/macOS：补全脚本通常在
/usr/share/bash-completion/completions/git或/usr/local/share/zsh/site-functions/_git - Windows（Git for Windows）：脚本路径一般是
C:\Program Files\Git\usr\share\bash-completion\completions\git - 检查是否加载：运行
complete -p git，有输出说明已注册；没输出就需手动加载
如何让 git checkout 和 git switch 补全分支名？
补全目标函数是 _git_checkout 和 _git_switch，它们依赖 __git_refs 获取本地+远程分支列表。要让它工作，得确保：
- bash 用户在
~/.bashrc末尾加：source /usr/share/bash-completion/completions/git（路径按实际调整） - zsh 用户在
~/.zshrc加：fpath=(/usr/share/zsh/site-functions $fpath)，再执行autoload -Uz compinit && compinit - Git 2.22+ 才支持
git switch补全；旧版本只能补git checkout - 补全默认只列本地分支；想包含远程分支（如
origin/main），得设git config --global completion.branches true
当前分支名怎么在 PS1 中高亮显示？
不能只靠 git branch --show-current，因为每次命令都调用它会明显拖慢 prompt 渲染。推荐用 __git_ps1 函数——它是 Git 补全脚本里自带的轻量级分支检测器。
- bash 下，在
~/.bashrc中启用：source /usr/share/bash-completion/completions/git-prompt.sh - 然后设置 PS1：
PS1='[\u@\h \W$(__git_ps1 " (%s)")]\$ '，括号内分支名会自动渲染 - 高亮需额外着色：把
$(__git_ps1 " (\033[32m%s\033[m)")放进 PS1，绿色仅作用于分支名部分 - zsh 用户别硬套 bash 方式；改用
$(git symbolic-ref --short HEAD 2>/dev/null)更稳妥，但注意空值处理
补全和高亮共存时容易卡顿？
问题常出在两个地方：一是 __git_ps1 默认会检查远程状态（比如是否落后），二是补全脚本在大仓库里扫描所有 ref 时耗时明显。
- 禁用远程检查：设
git config --global bash.showUpstream "no"，避免每次 prompt 都跑git rev-list - 提速补全：加环境变量
export GIT_COMPLETION_CHECKOUT_NO_GUESS=1，跳过模糊匹配逻辑 - 如果用的是 oh-my-zsh 或 powerlevel10k，它们自带优化过的 Git 提示；直接关掉自己写的
__git_ps1，改用主题内置方案更稳
真正麻烦的不是配置本身，而是不同 shell、不同 Git 版本、不同发行版对补全脚本路径和函数名的微小差异——同一段代码在 macOS 上跑得欢，在 WSL2 里可能找不到 git-prompt.sh。动手前先确认 git --version 和 $SHELL，比盲目粘贴配置重要得多。
