解决 Zsh 的补全错误：以 Bun 和 Claude-mem 为例

一、 现象

很多同学在安装 <code>claude-mem</code> 之后，每次打开终端（Terminal）都会看到下面这段恼人的提示：

zsh compinit: insecure directories…
Ignore insecure directories and continue [y] or abort compinit [n]?

如果你输入 <code>n</code>，紧接着就会跳出第二个错误：<code>command not found: compdef</code>。

这意味着，你的终端环境已经处于一种“半瘫痪”状态，自动补全功能失效了。

二、 原因

这个问题的本质，是 Zsh 的安全机制与 Bun 的自动化脚本之间发生了冲突。

1. 权限检查

Zsh 为了防止恶意脚本注入，要求补全脚本所在的目录，绝对不能允许“组用户”（group）有写入权限。

然而，在 macOS 上使用 Homebrew 时，<code>/opt/homebrew/share/zsh</code> 往往会被设置成组可写。Zsh 发现了这个“破绽”，于是拒绝启动补全系统。

2. 启动顺序

<code>claude-mem</code> 依赖 Bun。Bun 在安装时，会在 <code>~/.zshrc</code> 末尾添加一行加载代码。

这行代码包含一个 <code>compdef</code> 命令。但是，只有 <code>compinit</code> 运行成功后，Zsh 才会认识这个命令。既然第一步的权限检查没通过，<code>compinit</code> 没运行，那么第二步自然会报错“找不到命令”。

三、 解决方案

解决这个问题，不需要复杂的技巧，只需要简单的三步。

第一步：修复目录权限

打开终端，运行下面的命令。它的作用是取消组用户的写入权限（g-w），并确保你拥有这些目录。

sudo chown -R $(whoami) /opt/homebrew/share/zsh
chmod -R 755 /opt/homebrew/share/zsh

第二步：调整配置文件顺序

这是最重要的一步。你需要手动编辑 <code>~/.zshrc</code>，确保“初始化”永远在“使用”之前。

# 首先，设置环境变量
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

# 其次，初始化补全系统
# 建议加上 -i 参数，即便权限有问题也不要卡住启动过程
autoload -Uz compinit && compinit -i

# 最后，再加载 Bun 的脚本
[[ -s "$HOME/.bun/_bun" ]] && source "$HOME/.bun/_bun"

第三步：刷新缓存

Zsh 会把补全结果缓存起来。为了确保修改生效，我们需要清理掉旧的缓存文件。

rm -f ~/.zcompdump*
source ~/.zshrc

四、 结论

技术工具的“一键安装”脚本（如 Bun 的 install 脚本）虽然方便，但往往会破坏配置文件的逻辑顺序。

正确的逻辑应该是：先设置路径，再初始化环境，最后加载特定工具。

如果以后你安装其他工具也遇到了类似错误，只要按这个顺序检查，基本都能解决。