从Homebrew切换Git安装asdf后出现文件不存在错误排查

错误来源可能性 #

• oh-my-zsh插件残留配置：之前通过Homebrew安装asdf时，可能启用了oh-my-zsh的asdf插件，插件内部硬编码了Homebrew路径的asdf.sh。即使卸载Homebrew版asdf，插件仍会尝试加载该不存在的文件——omz reload会重新加载所有oh-my-zsh插件配置，因此触发报错，而source ~/.zshrc可能未完整触发插件的加载逻辑。
• Homebrew残留符号链接：brew --prefix asdf返回的/opt/homebrew/opt/asdf是指向Cellar中asdf keg的符号链接，卸载时可能未清理该软链，导致Homebrew仍能识别路径，但实际keg已删除，所以brew uninstall提示找不到keg。
• 其他zsh配置文件残留：除.zshrc和.zprofile外，.zshenv、.zlogin或~/.oh-my-zsh/custom/下的自定义脚本、全局配置文件（如/etc/zshrc）中可能存在引用旧路径asdf.sh的配置。
• 终端启动命令残留：终端工具（如iTerm2、Terminal）的启动配置中，可能直接添加了source /opt/homebrew/opt/asdf/libexec/asdf.sh这类命令。

解决步骤 #

1. 清理oh-my-zsh的asdf插件 #

• 检查是否启用了asdf插件：打开~/.zshrc，找到plugins=(...)行，若包含asdf则删除该条目，保存后执行omz reload。
• 若插件目录存在残留：删除对应插件目录，执行命令：

  rm -rf ~/.oh-my-zsh/plugins/asdf
  rm -rf ~/.oh-my-zsh/custom/plugins/asdf
  

2. 清理Homebrew残留软链 #

手动删除残留的符号链接：

rm -f /opt/homebrew/opt/asdf

执行后再运行brew --prefix asdf，应提示Error: asdf: unknown formula，说明残留已清理。

3. 排查所有配置文件中的旧路径 #

使用全局搜索命令查找所有引用旧asdf.sh路径的配置：

grep -r "/opt/homebrew/opt/asdf/libexec/asdf.sh" ~/.zsh* ~/.oh-my-zsh/ /etc/zsh* 2>/dev/null

找到对应的配置行后，删除该行或修改为Git安装的asdf路径（Git安装的asdf通常位于~/.asdf/asdf.sh）。

4. 配置Git版asdf（若未正确配置） #

在~/.zshrc中添加Git版asdf的加载配置：

# 加载asdf核心脚本
. $HOME/.asdf/asdf.sh
# 加载补全
. $HOME/.asdf/completions/asdf.bash

保存后执行source ~/.zshrc，确保无报错。

5. 检查终端启动配置 #

打开终端工具的偏好设置：

• iTerm2：Preferences > Profiles > Command，检查是否有自定义命令包含旧路径的source语句。
• Terminal：Settings > Profiles > Shell，检查Run command或Startup相关配置。
  若有则删除或修改为正确路径。

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