如何为Git自定义alias配置与Git顶层命令一致的Bash补全

前置已完成场景 #

目前已经成功为各类自定义Git别名配置了可用的Bash补全逻辑，示例可复现正常补全效果：

$ git config alias.subject
!git --no-pager show --quiet --pretty='%s'
$ function _git_subject() { _git_show; }
$ git subject my<TAB>
# 触发补全后输出
$ git subject my-branch

待适配的自定义别名 #

当前新增了一个用于查询指定Git别名配置的自定义别名，具体配置与运行效果如下：

# 别名配置定义
$ git config alias.alias
alias = !"f() { if [[ \"$#\" != 1 ]]; then >&2 echo \"Usage: git alias COMMAND\"; return 1; fi; git config alias.\"$1\"; }; f"

# 别名实际运行示例
$ git alias s
status

核心适配需求 #

该自定义别名的Bash补全行为，需要和Git顶层命令本身的补全行为完全一致，预期触发效果如下：

预期补全交互

$ git alias su<TAB>
# 弹出补全候选列表
subject     submodule
# 自动补全完成
$ git alias sub

已验证的无效方案 #

先后尝试了三种基于Git原生补全函数的实现，均会在按下Tab键触发补全时陷入死循环，无法返回正常交互：

# 无效实现1：直接调用_git
function _git_alias() { _git; }

# 无效实现2：直接调用__git_main
function _git_alias() { __git_main; }

# 无效实现3：调用__git_wrap__git_main
function _git_alias() { __git_wrap__git_main; }

无效根因：Git原生补全逻辑会自动为自定义Git别名匹配对应的补全函数，当在_git_alias中直接调用原生Git补全入口时，补全逻辑解析当前命令行参数，会再次匹配到_git_alias补全规则，形成无限递归。

可行适配实现 #

要达到和Git顶层命令完全一致的补全效果，需要在调用原生补全逻辑时，临时移除当前命令行中的alias参数，让补全逻辑识别当前为纯git命令的子命令补全场景，彻底打断递归路径。具体实现代码：

function _git_alias() {
  # 提取Bash补全上下文的参数
  local cur prev words cword
  _get_comp_words_by_ref -n = cur prev words cword

  # 调整补全参数列表：移除"git"后的"alias"参数，把待补全位置上移到原Git顶层子命令的补全位
  unset 'words[cword-1]'
  cword=$((cword - 1))

  # 调用Git原生顶层命令补全逻辑
  __git_wrap__git_main
}

该实现触发Tab补全时，会完全复用Git原生的顶层命令（含内置命令、自定义别名）补全逻辑，和预期效果完全一致，不会出现递归死循环。

扩展实现：仅补全Git自定义别名 #

可以非常轻松实现仅补全已配置的Git自定义别名、不展示Git内置命令的效果，不需要依赖Git原生补全的全量候选，具体实现：

function _git_alias() {
  local cur prev words cword
  _get_comp_words_by_ref -n = cur prev words cword

  # 拉取所有已配置的Git自定义别名作为候选列表
  local alias_list
  alias_list=$(git config --get-regexp '^alias\.' | awk -F'.' '{print $2}' | awk '{print $1}')

  # 匹配当前输入内容生成补全候选
  COMPREPLY=( $(compgen -W "${alias_list}" -- "${cur}") )
}

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