Como corrigir “comando Brew não encontrado” no Mac

Se você é um usuário regular do Homebrew, sabe como é uma ferramenta conveniente para instalar pacotes usando o Terminal. Você também pode ficar perplexo ao encontrar a mensagem de erro ‘Comando Brew não encontrado’ ao tentar usar o Homebrew em um shell zsh no Terminal. Geralmente é o seguinte:
zsh: command not found: brew, e neste artigo explicaremos as possíveis causas desse erro e mostraremos como corrigi-las.

O que é Homebrew?

Caso você ainda não tenha ouvido falar, Homebrew é uma ferramenta de gerenciamento de pacotes que permite instalar software de código aberto em seu Mac a partir da linha de comando do Terminal. É uma excelente maneira de, por exemplo, instalar o Git, para que você possa ‘extrair’ o código do GitHub e instalá-lo no seu Mac. Depois de instalar o Homebrew, os pacotes geralmente podem ser instalados com apenas um comando.

Por que o erro ‘Comando Brew não encontrado’ aparece no meu Mac?

Existem alguns motivos possíveis para a mensagem de erro aparecer, mas todos eles têm a mesma causa raiz: o shell zsh não consegue encontrar o binário brew para executar. Isso pode ser porque há algo errado com $PATH (a variável que especifica onde os programas executáveis ​​estão localizados) ou com a instalação do Homebrew.

Reinicie o Terminal

Antes de mergulhar em soluções mais complexas, vamos descartar um problema simples reiniciando o Terminal. Siga estas etapas:

1. Pressione Command-Option-Esc para abrir o menu Forçar Encerramento.
2. Selecione Terminal e clique em Forçar Encerramento.
3. Reabra o Terminal.
4. Na nova janela do Terminal, digite:brew doctor

Ao executar o brew doctor, você receberá uma de duas respostas. Uma mensagem dizendo: “Seu sistema está pronto para ser preparado” significa que tudo funciona corretamente. No entanto, se você receber um erro comozsh: command not found: brew, tente estas soluções.

Instale o Git

Git é um sistema de controle de versão distribuído que rastreia alterações em arquivos e geralmente vem pré-instalado no macOS. Git é uma dependência crítica para o Homebrew. O Homebrew usa repositórios Git para clonar, extrair e gerenciar atualizações de seus pacotes, garantindo que o sistema permaneça atualizado e confiável.

Antes de instalar o Git, vamos verificar se você já o possui:

1. Terminal aberto.
2. Tipogit --versione pressione Enter.

Se você vir um número de versão, o Git já foi instalado. Se você receber uma mensagem indicando que nenhuma ferramenta de desenvolvedor foi encontrada, digite
xcode-select --installe clique em Instalar na janela pop-up que aparece. Isso instalará as ferramentas de linha de comando Git e Xcode, que são essenciais para configurar um ambiente de desenvolvedor em seu Mac.

Atualize seu arquivo .zshrc

Brew se instala em/opt/homebrew/bin/, mas às vezes esse diretório não está incluído na configuração do seu shell. Para corrigir isso, siga estas etapas para atualizar seu arquivo .zshrc:

1. Abra o Terminal e navegue até o seu diretório inicial digitandocd
2. Agora, entrels -alpara listar os arquivos ocultos e verificar se você possui um arquivo .zshrc. Se você não vir .zshrc na lista, será necessário criá-lo.
3. Digitarclearpara limpar o Terminal.
4. Tiponano .zshrcpara entrar no editor de texto Nano.

   

5. Adicione o caminho do brew ao arquivo:export PATH="/opt/homebrew/bin:$PATH"
6. Para salvar e sair do Nano, pressione Control-X.
7. Quando solicitado com “Salvar buffer modificado”, pressione Y. Pressione Enter para confirmar e sair.

   

8. Verifique se o arquivo foi criado com sucesso: digitels -ale veja que .zshrc aparece na lista.
9. Por último, digitesource .zshrcpara carregar a nova configuração sem reiniciar o Terminal.
10. Correrbrew helppara ver se funcionou.

Este processo adiciona o caminho necessário para brew às suas sessões de shell interativas, garantindo que o comando brew seja reconhecido.

Leia também:5 maneiras de corrigir Zsh: comando não encontrado: erro de pip

A diferença entre .zshrc e .zprofile

Muitos usuários confundem .zshrc e .zprofile. Aqui está uma explicação mais clara: .zprofile é executado para shells de login iniciados quando você faz login no seu sistema. O arquivo .zshrc é executado para shells interativos, as sessões que você abre em uma nova janela ou guia do Terminal.

Ao solucionar problemas com o brew, você normalmente modifica .zshrc porque esse arquivo é lido pelos shells interativos que você usa no Terminal. Isso garante que cada nova sessão do Terminal carregue as configurações corretas do Homebrew imediatamente.

Reinstale o Homebrew

Se o Homebrew não estiver funcionando conforme o esperado, a solução mais simples é reinstalá-lo. Para fazer isso, siga as etapas abaixo.

1. Terminal aberto.
2. Digite ou cole o seguinte comando:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3. Pressione Retornar. Você verá informações na janela do Terminal explicando o que será instalado e onde será instalado.
4. Pressione Voltar novamente.
5. Digite sua senha de administrador e pressione Return.
6. Aguarde uma mensagem informando que a instalação foi concluída.
7. Agora você pode tentar o comando brew novamente para ver se funciona.

Se o erro ainda aparecer após a reinstalação do Homebrew, a próxima etapa é colocar brew no caminho zshrc. Para fazer isso, abra uma nova janela do Terminal e digite ou cole o comando abaixo seguido de Return:

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

Em seguida, use o comando abaixo para reparar o brew:brew doctor

Se você vir ‘Comando Brew não encontrado’ após instalar o Oh My Zsh

Se você acabou de instalar o Oh My Zsh para permitir a instalação de plug-ins para Zsh e, em seguida, vê o erro ‘Comando Brew não encontrado’, há outra coisa que você pode tentar. Você pode adicionar uma linha ao seu arquivo zshrc. O arquivo fica na pasta raiz do seu diretório inicial, mas está oculto. Para vê-lo, você pode visualizar os arquivos ocultos ou usar Finder > Ir > Ir para a pasta > ~/zshrc. Abra-o no Text Edit e adicione a linha abaixo. Em seguida, salve e feche-o.

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

Alternativamente, você pode usar o comando abaixo em uma janela do Terminal para adicionar a linha:

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

Em seguida, execute o brew doctor novamente usando o comando Terminal:brew doctor

A mensagem de erro ‘comando brew não encontrado’ significa que há um problema com a instalação do Homebrew no seu Mac. Siga as etapas acima para consertar e fazer o Homebrew funcionar novamente.