koalaman/shellcheck

O que é?

Recursos principais

• 01Detecta erros de aspas, condicionais inválidas e comandos usados incorretamente em scripts bash e sh.
• 02Aponta problemas de portabilidade em relação ao shebang do script, de forma semelhante ao checkbashisms.
• 03Explica cada aviso e inclui links para páginas detalhadas na wiki.
• 04Integra-se a diversos editores e serviços de CI.
• 05Gera saída em texto, JSON, CheckStyle XML ou mensagens compatíveis com GCC.

Casos de uso

• Analisar scripts de shell em um pipeline de CI para que novos avisos interrompam os builds.
• Encontrar variáveis sem aspas e padrões perigosos de rm ou find antes de executar um script.
• Verificar se um script escrito para /bin/sh não depende de recursos exclusivos do bash.
• Receber feedback em linha enquanto edita scripts de shell no seu editor.

Início rápido

1. 1

   Instale o ShellCheck com o Homebrew

   brew install shellcheck
2. 2

   Execute o ShellCheck em um script

   shellcheck yourscript

Antes de usar

• !Licenciado sob a GPL-3.0, uma licença copyleft.
• !A compilação a partir do código-fonte requer cerca de 2 GB de RAM.

Em coleções

Tópicos

Perguntas frequentes

O que é shellcheck?

Ferramenta de análise estática que encontra bugs, problemas de portabilidade e maus hábitos em scripts de shell bash e sh. O ShellCheck analisa scripts de shell e informa avisos e sugestões sobre erros de sintaxe, problemas semânticos e armadilhas sutis que podem fazer um script se comportar de forma inesperada ou falhar mais tarde. Ele é voltado a scripts bash e sh e aponta problemas como variáveis sem aspas, operadores de teste usados incorretamente, padrões inválidos de find ou grep e códigos de saída mascarados, com explicações para cada aviso.

shellcheck é gratuito? Qual é a licença?

shellcheck é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

shellcheck ainda é mantido?

Manutenção ativa. O último commit de shellcheck foi em 5 de nov. de 2026.

Para que posso usar shellcheck?

Analisar scripts de shell em um pipeline de CI para que novos avisos interrompam os builds. Encontrar variáveis sem aspas e padrões perigosos de rm ou find antes de executar um script. Verificar se um script escrito para /bin/sh não depende de recursos exclusivos do bash. Receber feedback em linha enquanto edita scripts de shell no seu editor.

Como instalar shellcheck?

Instale o ShellCheck com o Homebrew: brew install shellcheck Execute o ShellCheck em um script: shellcheck yourscript

Onde consigo shellcheck?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/koalaman/shellcheck