Erro Zsh · 4 min read · Oct 08, 2025
Como Corrigir o Erro de Comando Não Encontrado no Zsh no macOS

Às vezes, quando você tenta usar comandos no Terminal em um Mac, pode receber uma mensagem de erro que diz comando não encontrado.
A partir do macOS Catalina, a Apple mudou o sistema principal usado no Terminal de ‘bash’ para ‘zsh’. Uma das razões mais comuns para isso é que o shell não consegue encontrar o comando que você está tentando executar.
Portanto, se o seu Mac estiver executando o macOS Catalina ou uma versão mais recente, você pode ver um erro como “zsh: comando não encontrado: brew.”
Vamos corrigir o erro de comando não encontrado do Zsh da seguinte maneira através do terminal e outros métodos.
Tabela de Conteúdos
- Razões comuns para o erro de comando não encontrado do Zsh
- Como Corrigir o Erro de Comando Não Encontrado do Zsh? - 1. Verifique a Sintaxe
- Defina o ambiente $Path no arquivo .zshrc
- Certifique-se de que o pacote está instalado
- Crie o Perfil Zsh
- Reinstale/Restaurar o Mac
- Como Faço para Mudar para Comandos Zsh no Mac?
- Resolver o erro de comando não encontrado no macOS
Razões comuns para o erro de comando não encontrado do Zsh
O comando não está escrito corretamente, resultando em um erro.
Variável PATH incorreta para executar o comando Zsh (Z shell).
O pacote correto não está instalado.
Configuração recente incorreta para o comando Zsh.
Como Corrigir o Erro de Comando Não Encontrado do Zsh?
1. Verifique a Sintaxe
É comum receber um erro de comando não encontrado devido a erros de digitação ou erros de ortografia. Você o recebe ao digitar coisas manualmente, e caracteres indesejados são digitados.
Você deve verificar novamente o comando para ver se há erros. Recomendamos copiar o comando diretamente para o terminal em vez de
2. Defina o ambiente $Path no arquivo .zshrc
Um caminho em um sistema de arquivos aponta para um local específico. Da mesma forma, para comandos do Terminal, a variável de sistema PATH ($PATH) mostra os diretórios onde os programas executáveis estão armazenados.
Por causa do $PATH, seu Mac pode localizar facilmente esses arquivos quando você executa um comando, permitindo que você use apenas o nome do comando, como ‘ls’, em vez de seu caminho completo.
Portanto, você deve definir o $PATH antes de prosseguir para que não receba o erro de comando não encontrado.
- Pressione Command + Barra de Espaço para abrir a pesquisa Spotlight

- Pesquise e vá para o terminal.

- Cole o seguinte comando e pressione enter.
export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

Isso corrigirá o erro de comando não encontrado do zsh no macOS.
3. Certifique-se de que o pacote está instalado
Você pode receber um erro de comando não encontrado quando um pacote não está instalado enquanto você está tentando acessá-lo. Aqui está como você verifica se o pacote está instalado.
Para Homebrew
- Digite o seguinte comando e pressione enter para listar todos os pacotes instalados.
brew list
Para Pacotes Python
- Se você quiser ver os pacotes Python instalados, digite o seguinte comando e pressione enter.
pip list
4. Crie o Perfil Zsh
O erro de comando não encontrado pode ocorrer no Zsh se o arquivo .zshrc não for criado ou se estiver faltando certas configurações. Aqui está como você cria um perfil Zsh antes de inserir outros comandos.
- Digite o seguinte comando no terminal e pressione enter para redirecionar para o diretório inicial.
cd ~/- Depois disso, digite o seguinte comando para criar um perfil Zsh.
touch .zshrc
- Agora, vamos verificar o perfil Zsh abrindo-o.
open .zshrc- Você verá o arquivo zshrc aberto no editor de texto, confirmando a criação do perfil Zsh.

5 . Reinstalar/Restaurar o Mac
Quando você esgotou todas as opções para corrigir o erro de comando não encontrado, então é hora de começar do zero. Reinstalar o macOS pode ser uma solução para corrigir o erro de comando não encontrado do Zsh.
Especialmente se o erro for devido a um problema de sistema mais amplo, como arquivos de sistema corrompidos ou configurações mal configuradas, você pode usar o guia oficial da Apple sobre como reinstalar o macOS.
E se você fez backup do macOS usando o Time Machine, então você pode restaurá-lo de volta para um computador iniciado quando você não recebeu o erro de comando Zsh. Para isso também, você pode usar o guia oficial sobre como restaurar o macOS através do Time Machine.
Como Faço para Mudar para Comandos Zsh no Mac?
Para macOS Catalina e versões posteriores, o Zsh já deve estar definido como seu shell padrão. Aqui está como confirmar ou mudar para ele:
Verifique o Shell Atual:
No Terminal, verifique seu shell atual digitando echo $SHELL. Se retornar algo como /bin/zsh, então o Zsh já é seu shell padrão.
Mudar para Zsh (se necessário):
Digite o comando chsh -s /bin/zsh no Terminal. Você pode precisar inserir sua senha para confirmar essa mudança.
Reinicie o Terminal:
Finalmente, feche e reabra seu Terminal. Isso inicia uma nova sessão usando Zsh.
Resolver o erro de comando não encontrado no macOS
Então, aqui está como você pode corrigir o erro de comando não encontrado no macOS. Usar gerenciadores de pacotes como HomeBrew ou Macport, juntamente com Zsh, pode facilitar as coisas.
Certifique-se de digitar os comandos corretos para resolver os erros.
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.