Corrigindo Erros "command not found" - Soluções Quando Comandos Estão Ausentes

2026-05-13 Tempo de leitura: Cerca de 12 min Dificuldade: Intermediário+

O Que Você Vai Aprender

• Diagnosticar erros command not found em menos de 30 segundos
• Reconhecer padrões típicos para PATH / hash / sudo / cron
• Parar o problema "eu instalei mas não encontra" de acontecer novamente

1. As 5 Causas Raiz

Conclusão: As causas são: pacote ausente, PATH, hash obsoleto, secure_path do sudo ou erro de digitação.

Quase todo erro command not found se resume a uma destas:

2. Passos de Diagnóstico (Template de 30 Segundos)

Conclusão: Use command -v para verificar, echo $PATH para inspecionar e depois busque o pacote.

2-1. Verifique a existência primeiro

$ command -v ansible

• Saída presente --> o comando está visível. Se ainda falhar, é um problema de permissão (não command not found).
• Sem saída --> continue para 2-2.

2-2. Mostre o PATH

$ echo $PATH
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

Verifique se o diretório de instalação esperado está no PATH. Diretórios comuns:

• ~/.local/bin (pip install --user / pipx)
• ~/bin (adicionado automaticamente pelo ~/.profile do Ubuntu, mas apenas para login shells do bash)
• /usr/local/bin (ferramentas compiladas manualmente)
• /snap/bin (instalados via snap)

2-3. Busque o pacote

Se o comando não está instalado, descubra qual pacote o fornece.

# Ubuntu / Debian
$ apt-cache search ^ansible$
$ /usr/lib/command-not-found ansible    # dica util do Ubuntu

# RHEL / Fedora
$ dnf provides '*/ansible'

3. Correções Caso a Caso

Conclusão: As correções variam por caso: instalação recente, pip ou npm, erro de digitação e troca de shell.

3-1. Acabou de instalar mas ainda não encontra

O shell armazenou em cache um caminho antigo via hash.

$ hash -r          # funciona tanto no bash quanto no zsh
$ rehash           # idioma do zsh

Se isso não ajudar, ou o diretório bin do novo pacote não está no PATH, ou você instalou como um usuário diferente (ex: root).

3-2. pip install --user command not found

O local de instalação é ~/.local/bin. Adicione ao PATH.

$ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
$ source ~/.bashrc

3-3. npm install -g command not found

Verifique o prefixo de instalação com npm config get prefix. Se for /usr/local, você pode ter um problema de permissão. Se for um prefixo personalizado como ~/.npm-global, adicione seu bin ao PATH.

$ npm config get prefix
$ ls "$(npm config get prefix)/bin"

3-4. Sensibilidade a maiúsculas / erro de digitação

Nomes de arquivo no Linux são sensíveis a maiúsculas e minúsculas.

$ Vim file.txt      # --> command not found
$ vim file.txt      # OK

Liste candidatos:

$ compgen -c vim    # comandos que comecam com "vim"

3-5. Não encontra após trocar de shell

Ao trocar de bash --> zsh, o arquivo onde o PATH é configurado muda.

4. Persistindo o PATH Corretamente

Conclusão: Sempre adicione ao $PATH, nunca sobrescreva; use /etc/profile.d para todo o sistema.

4-1. Padrão recomendado

# No final de ~/.bashrc ou ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"

• A ordem (antes vs. depois de $PATH) controla a prioridade
• Coloque seus scripts personalizados antes de $PATH para sobrescrever comandos do sistema
• Coloque-os depois para deixar os comandos do sistema prevalecerem

# ERRADO: apaga o PATH existente
export PATH="$HOME/.local/bin"

4-2. PATH para todo o sistema

Use /etc/profile.d/*.sh. Note que /etc/environment aceita apenas atribuições de variáveis (sem sintaxe de shell).

# /etc/profile.d/myapp.sh
export PATH="/opt/myapp/bin:$PATH"

5. Não Encontra com sudo / cron

Conclusão: sudo usa secure_path e cron um PATH mínimo; use caminhos completos ou defina o PATH.

5-1. command not found com sudo

sudo sobrescreve o PATH com secure_path do /etc/sudoers.

$ sudo -V | grep -i path
Value to override user's $PATH with: /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

Correções:

# (1) Use o caminho completo (mais confiavel)
$ sudo /home/user/.local/bin/myscript

# (2) Transporte o ambiente com sudo -E (pode ser ignorado quando secure_path esta definido)
$ sudo -E env "PATH=$PATH" myscript

# (3) Correcao permanente: edite secure_path com visudo
$ sudo visudo
# Defaults secure_path="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/home/user/.local/bin"

5-2. command not found no cron

O cron inicia com um PATH mínimo.

$ env -i sh -c 'echo $PATH'
/usr/bin:/bin

Correções (em ordem de preferência):

# (1) Declare PATH no topo do crontab
PATH=/usr/local/bin:/usr/bin:/bin:/home/user/.local/bin
* * * * * myscript

# (2) Use caminhos absolutos no script
* * * * * /home/user/.local/bin/myscript

6. Template de Diagnóstico para Copiar e Colar

Conclusão: Um template para copiar e colar que executa verificação, PATH, hash, busca de pacote e checagens do sudo.

# 1. Verificar existencia
command -v ansible

# 2. Mostrar PATH
echo $PATH

# 3. Limpar hash (a correcao padrao logo apos instalar)
hash -r
command -v ansible

# 4. Buscar o pacote
apt-cache search ^ansible$       # Debian / Ubuntu
dnf provides '*/ansible'         # RHEL / Fedora

# 5. Verificar com sudo
sudo command -v ansible
sudo -V | grep -i path