在 Git Bash 中禁用远程分支的自动完成？

Question

我正在开发一个相当大的 git 存储库，其中包含数千个（远程）分支。我习惯于在控制台（在这种情况下是 Git Bash）中使用自动完成（使用 [TAB]），所以我也无意识地对 git 命令这样做了。

例如我会输入

git checkout task[TAB]

导致控制台经常停顿几分钟。有没有办法将自动完成仅限于本地分支？

Answer 1

使用 Git 2.13（2017 年第二季度），您可以禁用（部分）分支完成。

git checkout --no-guess ...
# or:
export GIT_COMPLETION_CHECKOUT_NO_GUESS=1

参见Jeff King (peff)commit 60e71bb（2017 年 4 月 21 日）。
^{（由 Junio C Hamano -- gitster -- 合并到 commit b439747，2017 年 5 月 1 日）}

现在contrib/completion/git-completion.bash 中记录：

您可以设置以下环境变量来影响完成例程的行为：

GIT_COMPLETION_CHECKOUT_NO_GUESS

当设置为“1”时，不要在git-checkout 中包含“DWIM”建议 完成（例如，当“origin/foo”存在时完成“foo”）。

注意：DWIM is short for Do What I Mean，系统试图预测用户打算做什么，自动纠正琐碎的错误，而不是盲目地执行用户明确但可能不正确的输入。

completion：可选择禁用签出 DWIM

当我们完成“git checkout”的分支名称时，我们还完成了可能触发 DWIM 行为的远程分支名称。根据您的工作流程和项目，这可能很方便，也可能很烦人。

例如，我的 gitster.git 克隆包含 74 个本地“jk/*”分支，但 origin 包含另外 147 个。
当我想签出本地分支但记不住名称时，选项卡完成会显示 251 个条目。更糟糕的是，对于一个已经为pu挑的话题，上游分支名称很可能和我的很相似，导致我很可能选错了，不小心创建了一个新的分支。

---

注意：“picked for pu”：见What's cooking in git.git：开头是：

以'-'为前缀的提交仅在'pu'（建议更新）中，而以'+'为前缀的提交在'next'中。

这是Git Workflow Graduation process 的一部分。

pu（提议的更新）是一个集成分支，用于尚未准备好包含的内容

---

此补丁为用户添加了一种告知完成的方式 不包含 DWIM 结帐建议的代码。
这可以通过键入来完成：

git checkout --no-guess jk/<TAB>

但这相当麻烦。

当然，缺点是当您确实想要调用 DWIM 行为时，您不再获得完成支持。
但是根据您的工作流程，这可能不会造成很大的损失（例如，在 git.git 中，我更有可能想要分离，所以无论如何我都会输入“git checkout origin/jk/<TAB>”）。

Answer 2

如果您通过自制软件安装了 git-completion，它位于此处： /usr/local/etc/bash_completion.d/git-completion.bash

按照上面的erik.weathers' answer，我进行了以下更改，因此自动完成功能可以根据当前前缀在本地和远程工作。默认情况下，它只会搜索本地，但如果我指定origin/…，它就会知道我也想搜索远程分支。

在_git_checkout ()方法中，改变

    __gitcomp_nl "$(__git_refs '' $track)"

到：

    # only search local branches instead of remote branches if origin isn't specified
    if [[ $cur == "origin/"* ]]; then
        __gitcomp_nl "$(__git_refs '' $track)"
    else
        __gitcomp_nl "$(__git_heads '' $track)"
    fi

当然，您可以将 origin 更改为其他名称，或者如果您有超过 1 个，您可以让它通过远程前缀列表搜索。

Answer 3

我假设您正在使用git-completion.bash 脚本，并且您只关心git checkout。

为此，我只是在git-completion.bash 中的_git_checkout () 函数的定义中更改了一行：

<       __gitcomp_nl "$(__git_refs '' $track)"
---
>       __gitcomp_nl "$(__git_heads '' $track)"

我的理解是这只会影响 tab-completion 动作（因为它在 switch-case 语句的* case 中的位置）。

Answer 4

Carey Metcalfe 写了a blog post，其中包含一个解决方案，该解决方案还可以编辑自动完成功能，但代码比其他答案稍新。他还定义了一个别名checkoutr，以保留旧的自动完成行为以备不时之需。

简而言之，首先使用以下命令创建 checkoutr 别名：

git config --global alias.checkoutr checkout

然后找到git-completion.bash，将_git_checkout 函数复制到你的shell 的RC 文件中，以便重新定义它，然后在该函数中，替换这一行：

__git_complete_refs $track_opt

以下几行：

if [ "$command" = "checkoutr" ]; then
    __git_complete_refs $track_opt
else
    __gitcomp_direct "$(__git_heads "" "$cur" " ")"
fi

有关更多详细信息和代码的潜在更新，请参阅the blog post。

Answer 5

你可以破解 /etc/bash_completion.d/git

您需要编辑__git_refs ()

请注意，行为的变化将适用于每个地方（因此即使使用 git push/pull 可能你不希望它出现）。当然，您可以复制该函数或传递一个额外的参数，但我将其留给您

Answer 6

您可以认为您只是别名为 co 的本地分支和带有完整命令 checkout 的所有分支。

您可以执行以下操作。在您的 .bashrc 中，您重新定义了 _git_checkout() 函数。你让这个函数保持不变，除了结尾：

if [ $command -eq "co" ]; then
  __gitcomp "$(__git_refs_local '' $track)"
else
  __gitcomp "$(__git_refs '' $track)"
fi

然后，您只需定义一个新函数 __git_refs_local，您可以在其中删除远程内容。

Answer 7

修改$(brew --prefix)/etc/bash_completion.d/git-completion.bash 不是一个好主意，因为每次通过 Homebrew 更新 Git 时它都会被覆盖。

在获取完成文件后，结合我在.bash_profile 中的完成文件中仅覆盖_git_checkout 函数的所有答案：

_git_checkout ()
{
  __git_has_doubledash && return

  case "$cur" in
    --conflict=*)
      __gitcomp "diff3 merge" "" "${cur##--conflict=}"
      ;;
    --*)
      __gitcomp "
      --quiet --ours --theirs --track --no-track --merge
      --conflict= --orphan --patch
      "
      ;;
    *)
      # check if --track, --no-track, or --no-guess was specified
      # if so, disable DWIM mode
      local flags="--track --no-track --no-guess" track=1
      if [ -n "$(__git_find_on_cmdline "$flags")" ]; then
        track=''
      fi
      # only search local branches instead of remote branches if origin isn't
      # specified
      if [[ $cur == "origin/"* ]]; then
        __gitcomp_nl "$(__git_refs '' $track)"
      else
        __gitcomp_nl "$(__git_heads '' $track)"
      fi
      ;;
  esac
}

Answer 8

我自己没有使用 Git Bash，但如果这与中提到的相同 http://tekrat.com/2008/04/30/bash-autocompletion-git-super-lazy-goodness/，你应该可以用普通的 git branch in

替换 git branch -a

_complete_git() {
  if [ -d .git ]; then
    branches=`git branch -a | cut -c 3-`
    tags=`git tag`
    cur="${COMP_WORDS[COMP_CWORD]}"
    COMPREPLY=( $(compgen -W "${branches} ${tags}" -- ${cur}) )
  fi
}
complete -F _complete_git git checkout

（在您的 .profile 或类似文件中）并获得您想要的。

Answer 9

这里的 FWW 是对 __git_complete_refs 的破解，可以解决问题

__git_complete_refs ()

{ 本地远程跟踪 pfx cur_="$cur" sfx=""

while test $# != 0; do
    case "$1" in
    --remote=*) remote="${1##--remote=}" ;;
    --track)    track="yes" ;;
    --pfx=*)    pfx="${1##--pfx=}" ;;
    --cur=*)    cur_="${1##--cur=}" ;;
    --sfx=*)    sfx="${1##--sfx=}" ;;
    *)      return 1 ;;
    esac
    shift
done
echo cur_ $cur_ > a
 if [[  $GIT_COMPLETION_CHECKOUT_NO_GUESS != 1 || $cur_ == "origin"* ]]; then
    __gitcomp_direct "$(__git_refs "$remote" "$track" "$pfx" "$cur_" "$sfx")"
  else
    __gitcomp_direct "$(__git_heads  "" "$cur_")"
  fi

}