在Zsh中配置Git自动补全脚本时出现_default命令未找到错误

我正尝试配置Zsh终端以使用Git的tab补全脚本，怀疑问题出在非标准文件结构上：

$ tree ~/Scripts
/Users/luigi/Scripts
├── connect.sh
├── git-completion.sh
├── git-completion.zsh
├── git-prompt.sh
└── pshell_connect.sh

我的.zshrc中关于tab补全的配置如下：

fpath=(~/Scripts $fpath)
source ~/Scripts/git-prompt.sh
zstyle ':completion:*:*:git:*' script ~/Scripts/git-completion.sh
source ~/Scripts/git-completion.zsh

启动终端会话时出现错误：

_git:19: command not found: _default

我之前使用Linux，大概率是配置失误而非缺少依赖。查看源码找到_git()函数，错误应该来自这一行：

let _ret && _default && _ret=0

不知道_default()函数应该在哪里定义，求问是配置问题还是缺少依赖？

问题原因 #

_default是Zsh自带补全框架的内置函数，报错是因为你没有先初始化Zsh的补全系统，导致这类核心补全函数未被加载。

修复步骤 #

1. 初始化Zsh补全系统：在加载Git补全脚本之前，给.zshrc添加以下配置：

   autoload -Uz compinit && compinit
   

   这行命令会启动Zsh的补全框架，自动加载包括_default在内的所有内置补全函数。

2. 调整配置顺序：把Git相关配置放到compinit之后，修改后的相关配置段如下：

   # 初始化Zsh补全系统
   autoload -Uz compinit && compinit
   
   # Git补全与提示配置
   fpath=(~/Scripts $fpath)
   source ~/Scripts/git-prompt.sh
   source ~/Scripts/git-completion.zsh
   

3. 清理冗余配置：注意git-completion.sh是Bash专用的补全脚本，Zsh不需要它，直接删掉zstyle ':completion:*:*:git:*' script ~/Scripts/git-completion.sh这一行即可，避免不必要的冲突。

验证 #

保存.zshrc后，重启终端或执行source ~/.zshrc，再尝试Git命令的tab补全，错误应该会消失。

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