如何修复 Mac 上的“未找到 Brew 命令”

如果您是 Homebrew 的常规用户，您就会知道使用终端安装软件包是多么方便的工具。当您尝试在终端的 zsh shell 中使用 Homebrew 时，遇到错误消息“未找到 Brew 命令”时，您可能也会感到困惑。通常是以下内容：
zsh: command not found: brew，在本文中，我们将解释导致此错误的可能原因并向您展示如何修复它们。

什么是自制程序？

以防万一您还没有听说过，Homebrew 是一个包管理工具，允许您从终端的命令行在 Mac 上安装开源软件。例如，这是安装 Git 的绝佳方法，这样您就可以从 GitHub 中“拉取”代码并将其安装到您的 Mac 上。安装 Homebrew 后，通常只需使用一个命令即可安装软件包。

为什么我的 Mac 上出现“找不到 Brew 命令”错误？

出现错误消息的可能原因有多种，但它们都有相同的根本原因：zsh shell 找不到要执行的brew 二进制文件。这可能是因为 $PATH（指定可执行程序所在位置的变量）或 Homebrew 安装有问题。

重启终端

在深入研究更复杂的解决方案之前，让我们通过重新启动终端来排除一个简单的问题。请按照下列步骤操作：

1. 按 Command-Option-Esc 打开“强制退出”菜单。
2. 选择终端并单击强制退出。
3. 重新打开终端。
4. 在新的终端窗口中，输入：brew doctor

当您运行brew doctor 时，您将收到两个响应之一。一条消息说“您的系统已准备好酿造”意味着一切正常。但是，如果您收到类似错误zsh: command not found: brew，尝试这些解决方案。

安装Git

Git 是一个分布式版本控制系统，可以跟踪文件的更改，通常预装在 macOS 上。 Git 是 Homebrew 的关键依赖项。 Homebrew 使用 Git 存储库来克隆、拉取和管理其软件包的更新，确保系统保持最新且可靠。

在安装 Git 之前，我们先检查一下您是否已经安装了它：

1. 打开终端。
2. 类型git --version并按 Enter 键。

如果您看到版本号，则表明 Git 已安装。如果您收到一条消息，指示未找到开发人员工具，请输入
xcode-select --install并在出现的弹出窗口中单击“安装”。这将安装 Git 和 Xcode 命令行工具，这对于在 Mac 上设置开发人员环境至关重要。

更新您的 .zshrc 文件

Brew 自行安装在/opt/homebrew/bin/，但有时该目录不包含在您的 shell 配置中。要解决此问题，请按照以下步骤更新您的 .zshrc 文件：

1. 打开终端并通过键入导航到您的主目录cd
2. 现在，输入ls -al列出隐藏文件并检查是否有 .zshrc 文件。如果您在列表中没有看到 .zshrc，则需要创建它。
3. 进入clear清除终端。
4. 类型nano .zshrc进入 Nano 文本编辑器。

   

5. 将brew的路径添加到文件中：export PATH="/opt/homebrew/bin:$PATH"
6. 要保存并退出 Nano，请按 Control-X。
7. 当提示“保存修改的缓冲区”时，按 Y。按 Enter 确认并退出。

   
8. 检查文件是否创建成功：输入ls -al并看到 .zshrc 出现在列表中。
9. 最后，输入source .zshrc无需重新启动终端即可加载新配置。
10. 跑步brew help看看它是否有效。

此过程将brew 的必要路径添加到交互式shell 会话中，确保brew 命令被识别。

.zshrc 和 .zprofile 之间的区别

许多用户混淆了 .zshrc 和 .zprofile。这里有一个更清晰的解释： .zprofile 是在您登录系统时启动的登录 shell 执行的。 .zshrc 文件针对交互式 shell 执行，即您在新的终端窗口或选项卡中打开的会话。

在对brew 问题进行故障排除时，您通常会修改 .zshrc，因为该文件是由您在终端中使用的交互式 shell 读取的。这可确保每个新的终端会话立即加载正确的 Homebrew 设置。

有关的：如何修复 Shift Command 4 在 Mac 上不起作用的问题

重新安装自制程序

如果 Homebrew 未按预期工作，最简单的解决方案是重新安装它。为此，请按照以下步骤操作。

1. 打开终端。
2. 键入或粘贴以下命令：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3. 按回车键。您将在终端窗口中看到信息，解释将安装什么以及安装位置。
4. 再次按回车键。
5. 输入您的管理员密码并按回车键。
6. 等待一条消息告诉您安装已完成。
7. 您现在可以再次尝试brew命令以查看它是否有效。

如果重新安装 Homebrew 后错误仍然出现，下一步是将brew 放入 zshrc 路径中。为此，请打开一个新的终端窗口，然后键入或粘贴以下命令，然后按 Return 键：

echo "export PATH=/opt/homebrew/bin:$PATH" >> ~/.zshrc

接下来，使用以下命令修复brew：brew doctor

如果您在安装 Oh My Zsh 后看到“未找到 Brew 命令”

如果您刚刚安装 Oh My Zsh 以允许安装 Zsh 插件，然后看到“未找到 Brew 命令”错误，那么您可以尝试其他方法。您可以在 zshrc 文件中添加一行。该文件位于主目录的根文件夹中，但它是隐藏的。要查看它，您可以查看隐藏文件或使用 Finder > 前往 > 前往文件夹 > ~/zshrc。在文本编辑中打开它并添加下面的行。然后，保存并关闭它。

eval $(/opt/homebrew/bin/brew shellenv)

或者，您可以在终端窗口中使用以下命令来添加行：

echo "eval $(/opt/homebrew/bin/brew shellenv)" >> ~/.zshrc

接下来，使用终端命令再次运行brew doctor：brew doctor

错误消息“brew 命令未找到”表示 Mac 上安装 Homebrew 时出现问题。按照上述步骤修复它并让 Homebrew 重新运行。