在Zsh中实现git add/ga命令的未暂存文件路径自动补全

我完全懂你想要的那种便捷感——不用手动复制粘贴文件路径，敲个git add或者别名ga就能直接选未暂存的文件，用箭头键挑就行。之前的尝试没成功没关系，咱们一步步来搞定这个问题。

方法一：自定义补全函数（适合原生Zsh或不想依赖插件的场景） #

首先得确保你的Zsh启用了现代补全系统，先检查~/.zshrc里有没有这两行，如果没有就加上：

autoload -Uz compinit
compinit

这两行是加载Zsh补全功能的基础。

接下来添加自定义的补全逻辑，把这段代码放进~/.zshrc：

# 定义针对未暂存文件的补全函数
_git_add_unstaged() {
  # 从git status里提取未暂存的修改文件（排除已删除、新增未追踪的文件）
  local unstaged_files=($(git status --porcelain | awk '/^.[^?AD] / {print substr($0, 4)}'))
  # 把提取到的文件作为补全选项展示
  _describe 'Unstaged modified files' unstaged_files
}

# 把补全函数绑定到git add和你的别名ga上
compdef _git_add_unstaged git add
compdef _git_add_unstaged ga

如果连未追踪的文件（比如你例子里的.vscode/）也想纳入补全，就把函数里的/^.[^?AD] /改成/^.[^AD] /就行。

最后重新加载配置生效：

source ~/.zshrc

现在敲git add 或者ga 之后按Tab，就能看到所有符合条件的文件，用箭头键选就好。

方法二：用Oh My Zsh的Git插件（省心又全面） #

如果你用的是Oh My Zsh，其实自带了完善的Git命令补全，根本不用自己写函数：

1. 打开~/.zshrc，找到plugins那一行，确保里面包含git：

plugins=(git)

（如果还有其他插件，直接把git加进去就行，比如plugins=(git zsh-syntax-highlighting)）

2. 重新加载配置：

source ~/.zshrc

这样不仅git add，所有Git命令的补全都能正常工作，而且ga作为Oh My Zsh默认的git add别名，也会自动继承补全功能，连未暂存、未追踪的文件都能自动提示。

为什么你之前的方法没生效？ #

你之前写的compctl -K _autocomplete_unstaged_paths少了关键一步——没指定要绑定的命令！Zsh根本不知道什么时候触发这个补全函数。就算要继续用旧的compctl，也得写成compctl -K _autocomplete_unstaged_paths git add ga才行。不过更推荐用上面的compdef方式，这是Zsh现在主推的补全系统，兼容性和扩展性都更好。

备注：内容来源于stack exchange，提问作者Kartik Chauhan