使用iTerm与oh-my-zsh时执行cd切换目录报错如何解决？

原生cd作为shell内置命令，报错逻辑不会涉及查找项目配置文件，出现该报错的核心原因是**cd命令被自定义钩子/别名覆盖**，覆盖逻辑和Laravel生态工具相关：
你大概率配置了进入目录自动检测Laravel项目的脚本（比如Laravel Sail的自动化脚本、Laravel相关的shell扩展），cd执行时会自动触发脚本逻辑扫描当前及上级目录的Laravel配置文件（如artisan、.env），进入非Laravel目录时扫描不到配置就会抛出该错误。
你提供的.zshrc中没有相关自定义逻辑，该配置大概率写在其他zsh加载文件（~/.zprofile、~/.zlogin、~/.oh-my-zsh/custom/目录下的自定义.zsh文件）中。

• 首先验证是否为自定义逻辑覆盖问题：执行builtin cd 目标目录，如果可以正常进入目录即可确认是覆盖问题。
• 执行which cd，如果输出不是cd: shell built-in command，即可确认存在别名/函数覆盖。
• 排查所有zsh加载文件，搜索cd别名定义、chpwd钩子相关的代码，找到和Laravel/Sail相关的自动检测逻辑。
• 要么直接删除该段逻辑，要么补充存在性判断避免非Laravel目录报错，参考修改示例：

# 原错误逻辑示例（进入目录就执行sail相关操作）
chpwd() {
  sail up -d
}

# 修复后逻辑（仅当前目录存在Laravel入口文件artisan时才执行操作）
chpwd() {
  if [ -f "./artisan" ]; then
    sail up -d
  fi
}

• 修改完成后执行source ~/.zshrc让配置生效，再次测试cd命令即可恢复正常。

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