首页/排错/Homebrew command not found
Homebrew 路径修复

Homebrew 的 command not found,通常不是没装上,而是 shell 还没把 brew 二进制正确暴露出来

这个变体值得单独做一页,因为 Homebrew 用户往往相信安装步骤本身没问题,却忘了终端会话还需要正确导出并优先使用 Homebrew 路径。

本页是站内详情页DeepSeek TUI Homebrew command not found排错

这页应该先回答的问题

  • brew 安装位置是不是当前 shell 真正导出的目录?
  • 有没有别的包管理路径把 brew 二进制挡住?
  • 你是不是只在旧终端窗口里测过,没有用全新会话验证?

这页应该帮你判断什么

这页要帮助用户定位 brew 路径暴露、shell 启动文件顺序,以及其他安装路线造成的二进制遮挡问题。

快速定位

Brew 目录位置

先确认包是不是装在机器当前真正使用的 Homebrew 前缀下面。

Shell 导出

确认当前 shell 启动文件里确实导出了对应 Homebrew bin 目录,而且用于你真正工作的那个终端。

二进制遮挡

检查是不是旧的 npm、cargo 或手动二进制先被解析到了。

逐步处理流程

  1. 先确认 brew 安装确实存在
    不要一开始就假设安装失败,先确认包已经在 brew 体系里。
  2. 检查当前 shell 路径顺序
    确认 Homebrew bin 目录已导出,而且位置足够靠前。
  3. 用全新终端重测
    只在当前窗口里生效的修复,不算真正稳定。
  4. 处理竞争路径
    如果别的安装路线先被命中,brew 安装虽然存在,但等于不可见。

常见误区

  • 路径问题还没查,就一直重复 `brew install`。
  • 以为 macOS 上所有终端都读同一套启动文件。
  • PATH 里还有别的包管理器二进制更靠前,却把锅甩给 Homebrew。

什么时候可以离开这页

当 brew 对应的二进制已经在你日常使用的 shell 里优先解析出来时,就可以离开这页了。

直接可用的示例

先拿可执行例子,再回头做更细的调整。

先确认 brew 里真的有这个包,再动 PATH

先证明确实装在 Homebrew 里,再去看当前 shell 有没有导出正确前缀。

brew list | rg deepseek-tui || true
command -v codewhale || which codewhale

用全新终端重测 brew 路径修复

brew 的路径修复必须在新终端 profile 里也稳定存在,才算真的修好。

command -v codewhale || which codewhale
# 完全退出终端再打开后重跑

常见失败分支

先判断你卡在哪一层,再去对应分支,不要把所有问题都混成一个。

brew 里看得到包,但 shell 看不到命令

那首先是路径导出问题,不是包安装问题。

brew 路径在,但还是别的二进制先赢

先查 npm、cargo 或手动二进制遮挡,再来怪 Homebrew。