"command not found" para seus próprios scripts - PATH e chmod

2026-06-06 Tempo de leitura: Cerca de 10 min Dificuldade: Intermediário

O que você vai aprender

• Por que apenas o seu script diz command not found
• Como diferenciar command not found de Permission denied
• Como seguir na ordem ./, chmod +x, PATH e hash -r

Por que apenas o meu script diz command not found?

Conclusão: O bash busca um nome de comando simples apenas nos diretórios listados no PATH. O diretório atual não está no PATH por padrão, então digitar script.sh não encontra nada.

Quando você digita script.sh, o bash resolve na seguinte ordem:

1. Funções do shell, aliases e builtins
2. Caminhos já em cache no hash
3. Os diretórios listados na variável de ambiente PATH (do início ao fim)

Se script.sh não está em nenhum dos diretórios do PATH, você recebe command not found mesmo que o arquivo esteja bem na sua frente.

$ ls
script.sh

$ script.sh
bash: script.sh: command not found

Deixar o diretório atual (.) fora do PATH é um padrão de segurança deliberado. Se . estivesse no início do PATH, um atacante poderia colocar um arquivo malicioso com nome de um comando real (ls) em um diretório onde você faz cd, e você o executaria por acidente. Por isso um script "bem aqui" precisa ser nomeado explicitamente.

Qual a diferença entre command not found e Permission denied?

Conclusão: command not found significa "não localizado"; Permission denied significa "localizado, mas sem permissão de execução." A mensagem indica qual caminho seguir.

Esses dois erros têm causas e correções diferentes.

# O caminho esta certo, mas nao ha permissao de execucao
$ ./script.sh
bash: ./script.sh: Permission denied

Se adicionar ./ muda o erro para Permission denied, o problema de PATH está resolvido e a próxima questão são permissões. Se você vê bad interpreter, o shebang ou terminações de linha estão com problema, então leia Corrigindo "bad interpreter".

Execute com ./ primeiro

Conclusão: Execute um script no diretório atual com ./script.sh. O ./ é um caminho explícito que pula a busca no PATH.

# NG: apenas o PATH e buscado, entao nao e encontrado
$ script.sh
bash: script.sh: command not found

# OK: nomeie o arquivo no diretorio atual diretamente
$ ./script.sh
Hello

Se está em outro lugar, use um caminho absoluto ou relativo.

$ /home/alice/tools/script.sh
$ ~/tools/script.sh
$ bash script.sh        # passar ao bash funciona mesmo sem o bit de execucao

O que acontece sem permissão de execução?

Conclusão: Sem o bit de execução, ./script.sh para com Permission denied. Conceda com chmod +x.

Scripts recem-criados, baixados ou copiados frequentemente perdem a permissão de execução.

$ ls -l script.sh
-rw-r--r-- 1 alice alice 42 Jun  6 10:00 script.sh

$ ./script.sh
bash: ./script.sh: Permission denied

-rw-r--r-- não tem x (bit de execução). Adicione.

$ chmod +x script.sh
$ ls -l script.sh
-rwxr-xr-x 1 alice alice 42 Jun  6 10:00 script.sh

$ ./script.sh
Hello

Como adicionar meu diretório ao PATH?

Conclusão: Para evitar digitar ./ toda vez, adicione o diretório do seu script ao PATH. Coloque export PATH no ~/.bashrc para tornar permanente.

Primeiro, verifique o PATH atual.

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

Adicione o diretório onde você guarda seus scripts (por exemplo ~/bin).

# Apenas para esta sessao (shell atual)
$ export PATH="$HOME/bin:$PATH"

Para tornar permanente, adicione ao final de ~/.bashrc (ou ~/.profile para login shells).

# Adicionar ao final de ~/.bashrc
export PATH="$HOME/bin:$PATH"

# Recarregar no shell atual
$ source ~/.bashrc

$ which script.sh
/home/alice/bin/script.sh

$ script.sh        # executa sem ./
Hello

Ainda não encontra, ou pega o binário antigo?

Conclusão: O bash armazena em cache o caminho de um comando uma vez que o encontra (hash). Logo após mover ou substituir um script, ele pode usar o caminho antigo. Limpe o cache com hash -r.

Quando PATH e permissões parecem corretos mas o comportamento está errado, use type para ver o que o bash realmente pretende executar e de onde.

$ type -a script.sh
script.sh is /home/alice/bin/script.sh

Se type aponta para um local antigo, ou um comando que você excluiu ainda executa, o cache está desatualizado.

# Limpar caminhos de comandos em cache
$ hash -r

# Verificar novamente
$ type -a script.sh