APIs com Golang - 2026

5 - Automatizando o Desenvolvimento com Live Reload (Air)

Até agora, sempre que fazemos uma alteração no nosso código, precisamos parar o servidor no terminal usando Ctrl + C e rodar go run main.go novamente. Para deixar nosso fluxo de trabalho muito mais rápido e produtivo, vamos instalar uma ferramenta de Live Reload chamada Air, que reinicia o servidor automaticamente a cada alteração salva.

Passo 1: Instalação do Air

A comunidade Go mantém o projeto air-verse/air especificamente para essa função. Para instalá-lo globalmente no seu computador, abra o seu terminal e execute o seguinte comando oficial do Go:

go install github.com/air-verse/air@latest

O Go vai baixar e compilar a ferramenta, gerando um arquivo executável dentro da pasta padrão de binários do Go no seu sistema operacional.

Passo 2: Como executar o Air (Caminho Padrão)

Por padrão, o executável do Air é salvo em uma pasta específica do sistema. Para rodar a ferramenta dentro da pasta do seu projeto (api_alunos), você pode chamá-la referenciando o caminho completo de onde ela foi instalada:

• No Windows: No terminal do VSCode, execute o comando:

C:\Users\SEU_USUARIO\go\bin\air

• No Mac / Linux: No terminal do VSCode, execute o comando:

~/go/bin/air

Ao rodar esse comando, o Air vai assumir o controle do seu terminal, iniciar o servidor e ficar monitorando qualquer alteração nos seus arquivos .go.

Passo 3: Executando de forma direta (Sem precisar do caminho longo)

Ficar digitando esse caminho completo toda vez pode ser cansativo. Existe uma maneira muito mais prática: configurar o seu sistema operacional para reconhecer a palavra air diretamente em qualquer pasta. Para fazer isso, precisamos adicionar a pasta bin do Go às Variáveis de Ambiente (PATH) do seu sistema.

Configurando no Windows:

1. No menu iniciar do Windows, pesquise por "Editar as variáveis de ambiente do sistema" e abra essa opção.
2. Clique no botão Variáveis de Ambiente... (na parte inferior da janela).
3. Na seção Variáveis do usuário, procure pela variável chamada Path, selecione-a e clique em Editar....
4. Clique em Novo e cole o caminho da sua pasta de binários do Go (geralmente é C:\Users\SEU_USUARIO\go\bin, substituindo SEU_USUARIO pelo nome da sua conta no Windows).
5. Clique em OK em todas as janelas para salvar, feche o seu VSCode e abra-o novamente para aplicar as alterações.

Configurando no Mac / Linux:

1. Abra o seu terminal e edite o arquivo de configuração do seu terminal (geralmente o ~/.zshrc ou ~/.bashrc) usando o comando: nano ~/.zshrc.
2. Adicione a seguinte linha no final do arquivo:

export PATH=$PATH:$(go env GOPATH)/bin

1. Salve o arquivo (Ctrl + O, depois Enter e Ctrl + X para sair) e recarregue o terminal com o comando: source ~/.zshrc.

O Resultado Final

Depois de fazer essa configuração uma única vez, você nunca mais precisará digitar caminhos longos. Sempre que abrir a pasta de um projeto no terminal do VSCode, bastará digitar apenas:

air

O Air começará a rodar imediatamente. Experimente alterar o texto do seu "Hello World!" para "Olá Mundo!" no arquivo main.go, salve o arquivo e veja a mágica acontecer no terminal sem que você precise reiniciar nada manualmente!

Você pode acompanhar cada etapa descrita acima no vídeo a seguir: