如何在Git自动补全中不显示标签？

当使用Git自动补全功能（比如执行git checkout命令时），补全结果会包含所有标签，随着标签数量增多，可读性变得极差。例如：

当前分支列表：

user:~/repo$ git branch
  prod
  staging
  master
  user_branch1
  user_branch2

执行git checkout user_后的补全结果（混入大量标签）：

user:~/repo$ git checkout user_
  user_remote_branch3
  user_branch1
  user_branch1-2023-06-19T1042-6386b7b427
  user_branch1-2023-06-19T1555-cf61155208
  user_branch1-2023-07-19T1818-808a0fa125
  user_branch1-2023-07-19T1839-8c379cf567
  user_branch1-2023-07-24T1125-4b50cd52a2
  user_branch2
  user_branch2-2023-06-21T1457-c323d6697a
  user_old_branch4-2023-06-21T1818-25006b3d62
  user_old_branch5-2023-03-02T1512-63fa5377f7

实际仅3个活跃分支，但补全结果超过30条。--no-guess选项无法移除标签，且因历史原因不能删除远程标签。之前考虑过两种方案，但都不够稳妥：

• 每次git pull/git fetch时不获取标签，但不知道如何自动实现，不想每次手动加--no-tags参数
• 删除本地现有标签，但一旦疏忽就需要重新清理，且未来可能还需要使用这些标签

以下是几种可行的解决方案：

方案1：自定义Git补全逻辑（推荐，不修改系统文件） #

直接修改系统的/usr/share/bash-completion/completions/git会被系统更新覆盖，建议在用户目录下创建自定义补全脚本：

1. 创建用户补全目录（如果不存在）：

   mkdir -p ~/.bash_completion.d
   

2. 创建自定义补全文件~/.bash_completion.d/git-custom，写入以下内容：

   # 覆盖git checkout的补全逻辑，仅显示分支
   _git_checkout() {
     __git_compose_command checkout
     # 仅补全分支（heads），排除标签（tags）
     __git_complete_refs --mode heads
   }
   

3. 在~/.bashrc中添加加载该脚本的配置：

   if [ -d ~/.bash_completion.d ]; then
     for f in ~/.bash_completion.d/*; do
       source "$f"
     done
   fi
   

4. 重新加载bash配置使生效：

   source ~/.bashrc
   

方案2：全局配置默认不获取标签 #

如果不需要自动同步远程标签，可以设置Git全局配置，让git pull和git fetch默认不获取标签：

# 设置fetch默认不获取标签
git config --global fetch.tags false
# 可选：禁止自动修剪标签（如果不需要）
git config --global fetch.pruneTags false

如果需要临时获取标签，可执行git fetch --tags。

方案3：临时修改补全规则（单次生效） #

如果只是临时需要仅补全分支，可以在当前bash会话中执行以下命令：

# 定义仅补全分支的checkout补全函数
_git_checkout_branch_only() {
  __git_compose_command checkout
  __git_complete_refs --mode heads
}
# 绑定到git checkout命令
complete -F _git_checkout_branch_only git checkout

该配置仅在当前会话生效，关闭终端后恢复默认。

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