Skip to main content

Erros de comando não encontrado

Descrição e sintomas​

Ao executar mgc no terminal, o sistema operacional retorna um erro indicando que o comando não existe.

Exemplo de erro:

$ mgc --version
command not found: mgc

Esse erro significa que o sistema operacional não consegue encontrar o comando mgc. Normalmente, isso indica uma das causas abaixo:

  • O terminal não foi reiniciado após a instalação e ainda não reconhece as atualizações feitas na variável PATH.
  • A instalação não foi concluída com sucesso.
  • O binário mgc não tem permissão de execução (Linux e macOS).
  • O diretório onde a CLI foi extraída não foi adicionado à variável PATH.

Solução​

  1. Reinicie o terminal. Feche todos os terminais abertos, não apenas o terminal ativo, e abra um novo para que ele reconheça as atualizações feitas na variável PATH.

  2. Reinstale a CLI. Se o comando mgc continuar não sendo encontrado, a instalação pode não ter sido concluída. Siga novamente os passos do seu sistema operacional em Download e instalação.

  3. Confira a permissão de execução do binário (Linux e macOS). Se você instalou a CLI a partir do arquivo .tar.gz, garanta que o binário tenha permissão de execução. Execute o comando abaixo, substituindo o caminho pelo diretório onde você extraiu a CLI.

    sudo chmod -R 755 ~/mgc_cli

    No macOS, na primeira execução, o sistema pode exibir um alerta de segurança. Vá até Configurações do Sistema > Privacidade e Segurança e confirme que aceita a execução do binário mgc.

  4. Adicione o diretório da CLI à variável PATH. Isso é necessário se você instalou a CLI a partir do arquivo .tar.gz (Linux/macOS) ou do arquivo .zip (Windows). Métodos como Homebrew, Snap, APT, pacote .deb e pacote .rpm já fazem essa configuração automaticamente.

    a. Descubra qual shell você está usando.

    echo $SHELL

    b. Adicione o diretório da CLI ao PATH no arquivo de perfil correspondente ao seu shell: ~/.bash_profile ou ~/.bashrc (Bash), ~/.zshrc (Zsh).

    export PATH=$HOME/mgc_cli:$PATH

    c. Recarregue o perfil na sessão atual, substituindo pelo arquivo que você editou no passo anterior.

    source ~/.bashrc   # ou ~/.bash_profile, ou ~/.zshrc

    a. Localize o arquivo mgc.exe em sua máquina.

    b. Pressione a tecla Windows e digite variáveis de ambiente.

    c. Selecione Editar as variáveis de ambiente da sua conta.

    d. Selecione a variável Path e clique em Editar.

    e. Adicione o caminho da pasta onde está o mgc.exe (por exemplo, C:\mgc).

    f. Clique em OK para aplicar as alterações.

    g. Feche todos os terminais abertos e abra um novo PowerShell.

  5. Confirme que o problema foi resolvido executando o comando abaixo. Ele deve retornar a versão instalada da CLI.

    mgc --version

Perguntas frequentes (FAQ)​

Reiniciar o terminal não resolveu. E agora? Tente reiniciar o sistema operacional. Algumas mudanças na variável PATH só são reconhecidas depois que o sistema é reiniciado, não apenas o terminal.

Como sei se a CLI foi realmente instalada? Procure o binário mgc (ou mgc.exe, no Windows) na pasta onde você fez a extração ou instalação. Se o arquivo não existir, a instalação não foi concluída e deve ser refeita.

Preciso repetir esses passos depois de cada atualização da CLI? Não, apenas na primeira instalação ou se você trocar de método de instalação (por exemplo, sair do .tar.gz manual para o Homebrew). Atualizações feitas pelo mesmo método preservam a configuração do PATH.