无需输入stash@{i}，用数字引用Git Stash并保留自动补全的方法

我之前也跟你一样，被git stash的索引输入和补全问题折腾过！用shell别名简化输入确实爽，但补全断了之后每次输选项都要查文档，太麻烦了。后来摸索出两个实用的方案，完美解决这个问题：

方案一：改进Git别名+适配补全脚本 #

这种方法不用额外创建脚本，只需要调整别名配置和添加补全规则：

1. 调整Git别名 #

先把你的别名改成更直接的参数转换形式，在~/.gitconfig里更新：

[alias]
  sshow = "!f() { git stash show stash@{$1} ${@:2}; }; f"

和你原来的别名类似，但保持了参数传递的灵活性，后面的参数会原封不动传给git stash show。

2. 添加补全规则（以Bash为例） #

打开你的~/.bashrc或~/.bash_profile，添加以下补全函数：

_git_sshow() {
  # 第一个参数补全stash的数字索引
  if [[ $COMP_CWORD -eq 1 ]]; then
    # 从git stash list里提取所有stash的索引数字
    COMPREPLY=($(git stash list | awk -F: '{gsub(/stash@\{|\}/, "", $1); print $1}'))
  else
    # 从第二个参数开始，复用git stash show的补全逻辑（也就是git diff的补全）
    shift
    _git_stash_show
  fi
}

保存后执行source ~/.bashrc生效。

现在测试一下：

• 输入git sshow <Tab>，会自动列出所有可用的stash数字索引（0、1、2...）
• 输入git sshow 1 --<Tab>，会和原生git stash show一样弹出所有git diff相关的选项补全

方案二：用Git自定义命令（更优雅） #

Git支持自定义命令：只要你在PATH里放一个名为git-xxx的可执行脚本，就能用git xxx来调用它。这种方式的补全适配更简单，也更符合Git的设计逻辑：

1. 创建自定义命令脚本 #

在你的PATH目录（比如~/bin）下创建git-sshow文件，内容如下：

#!/bin/bash

# 如果第一个参数是纯数字，自动转换成stash@{N}格式
if [[ $1 =~ ^[0-9]+$ ]]; then
  set -- "stash@{$1}" "${@:2}"
fi

# 直接调用原生git stash show命令，传递所有参数
exec git stash show "$@"

2. 给脚本加执行权限 #

chmod +x ~/bin/git-sshow

3. 配置补全规则 #

Bash环境

在~/.bashrc里添加：

complete -F _git_stash_show git-sshow

Zsh环境

在~/.zshrc里添加：

compdef _git_stash_show git-sshow

配置完成后，git sshow的补全完全和原生git stash show一致：

• 输入git sshow <Tab>，既可以选数字索引，也能直接选stash@{N}格式的引用
• 后续的选项补全（比如--name-only、--diff-filter等）和原生命令完全同步

为什么原来的别名补全失效？ #

Git的自动补全脚本是针对内置命令和简单别名设计的，如果别名是用!开头的shell函数，补全脚本无法解析函数内部的参数转换逻辑，所以不会自动应用git stash show的补全规则。上面两种方法要么手动适配补全逻辑，要么通过自定义命令让Git识别这是stash show的封装，从而继承补全上下文。

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