ZSH目录补全仅在执行exec zsh后生效如何解决

这类问题核心原因基本都是补全初始化时机不对：首次启动终端时，ZSH补全系统没扫到第三方命令的补全规则，TAB触发时就fallback到最基础的文件目录补全；执行exec zsh重载时，配置二次加载把缺的补全规则注册上了，功能就恢复正常。按下面的顺序排查就行：

1. 检查compinit加载顺序 #

这是最高发的诱因：

• 打开~/.zshrc，找到compinit相关的初始化行。ZSH补全的加载逻辑是：先把所有补全规则所在的目录加入$fpath数组（包括oh-my-zsh插件补全目录、Homebrew补全目录——Apple Silicon默认路径是/opt/homebrew/share/zsh/site-functions，Intel芯片默认是/usr/local/share/zsh/site-functions、其他第三方工具的补全目录），最后再执行compinit扫描所有fpath下的补全规则完成初始化。
• 常见错误写法：把compinit写在.zshrc靠前位置，后面才加载oh-my-zsh、Homebrew、其他插件的配置。首次启动时compinit先执行，后续才把补全目录加进fpath，自然扫不到对应规则；exec zsh时上一次会话已经把fpath写入当前shell环境，二次启动执行compinit就能扫到所有补全。
• 修复方式：把手动写的compinit行挪到.zshrc最末尾，挪到所有插件、第三方工具配置的后面。如果用oh-my-zsh，框架本身会在所有配置加载完成后自动执行compinit，自己额外提前写的compinit直接删掉即可。

2. 修复损坏的补全缓存 #

如果加载顺序没问题，大概率是补全缓存文件损坏，执行以下命令删除旧缓存重新生成即可：

rm -f ~/.zcompdump*
compinit

注意不要在.zshrc里重复多次执行compinit，会拖慢shell启动速度，还可能导致补全规则互相覆盖。

3. 检查插件管理器加载配置 #

如果用zinit、zplug、antidote这类第三方ZSH插件管理器，检查是否给核心补全插件加了延迟加载配置（比如wait关键字）：

• 比如给Homebrew补全、系统补全库加了wait'1'的延迟加载参数，首次启动后1秒内按TAB时补全规则还没注入，就只会显示目录补全。
• 修复方式：把核心命令补全类插件的延迟加载配置去掉，设置为启动时立即加载即可，非核心插件再保留懒加载。

4. 排查shell配置文件加载混淆问题 #

不要把补全、插件、交互终端相关的配置写到~/.zprofile里，这个文件仅在登录shell启动时加载一次，部分场景下交互shell读取不到会导致补全初始化失败。所有交互终端相关的配置、补全规则、插件加载逻辑全部放到~/.zshrc中，~/.zprofile仅放PATH这类登录时需要初始化的环境变量即可。

验证修复效果：完全退出终端应用后重新打开，不要执行exec zsh，直接输入brew install spot按TAB，能正常弹出包名补全即修复完成。

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