Fish shell执行cd ~/Downloads报'is a rotten symlink'错误如何解决

错误触发原因 #

这个报错是Fish内置cd逻辑在路径解析阶段，检测到目标路径或路径的前置组件存在失效的符号链接触发的，你排查发现Downloads本身不是软链接，大概率是以下几种隐性情况导致的：

• CDPATH环境变量中存在失效的软链接条目，cd时优先匹配到了该条目下的失效路径
• 你自定义了cd函数覆盖了Fish内置实现，自定义逻辑存在路径解析bug
• Fish本地缓存的路径映射数据损坏，导致路径解析错误
• macOS的隐私访问限制拦截了Fish对Downloads目录的访问，系统调用返回的异常被Fish误识别为失效软链接

修复方案 #

• 第一步：排查CDPATH配置
  在Fish中执行echo $CDPATH，检查输出的所有路径是否都存在且没有失效软链接，如有异常，打开~/.config/fish/config.fish删除错误的CDPATH赋值配置，重启Fish后重试。
• 第二步：排查自定义cd函数
  执行functions cd，如果返回的结果不是内置函数提示，说明你配置了自定义的cd函数，可临时执行builtin cd ~/Downloads测试是否能正常进入目录，确认是自定义函数问题后删除对应配置即可。
• 第三步：清除Fish路径缓存
  执行以下命令清除本地路径缓存后重启Fish重试：

  set -e fish_path
  

• 第四步：修复macOS权限配置
  打开macOS「系统设置」→「隐私与安全性」→「完整磁盘访问权限」，勾选你正在使用的终端应用（Terminal.app/iTerm2等）的权限开关，重启终端后重试。
• 第五步：排查自定义配置冲突
  临时重命名Fish配置目录测试：

  mv ~/.config/fish ~/.config/fish.bak
  

  新开Fish窗口测试cd行为，如恢复正常则说明原有自定义配置存在冲突，可逐步回迁配置定位问题项即可。

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