Login
Login

Como instalar o Go no macOS

Como instalar o Go no macOS
Hostman Team
Technical writer
Linguagem Go
16.07.2025
Reading time: 7 min

O macOS é um sistema operacional para computadores de mesa e notebooks, desenvolvido pela Apple para seus próprios dispositivos. Ele vem pré-instalado em todos os aparelhos da Apple, especialmente no Apple Macintosh, conhecido como Mac.

Diferente do Linux, o macOS é um sistema operacional proprietário, o que traz algumas particularidades na instalação de ferramentas de desenvolvimento. Para saber mais, confira nosso guia sobre como implantar um servidor em nuvem no macOS.

Neste artigo, vamos mostrar em detalhes como instalar o Go em um computador com macOS.

Golang, ou apenas Go, é uma linguagem de programação de código aberto desenvolvida pelo Google para criar aplicações com arquitetura de microsserviços. Na nossa plataforma de aplicações, você encontra diversos frameworks Go, como Beego e Gin.

Para garantir a estabilidade do seu computador e do compilador Go, recomendamos o uso da versão mais recente do macOS.

1. Remover versões antigas do Go

Verificar se o Go já está instalado

Antes de instalar o Go, verifique se ele já está presente no sistema. Para isso, execute o seguinte comando no terminal:

go version

Se o Go estiver instalado, você verá uma mensagem como:

go version go1.21.3 darwin/amd64

Desinstalar o Go

Se o Go estiver instalado, é necessário removê-lo para evitar conflitos na instalação.

O macOS armazena os arquivos do Go nos seguintes diretórios:

  • /usr/local/go onde está instalado o Go.

  • /etc/paths.d/go onde ficam as variáveis de ambiente do Go.

Use os comandos abaixo para remover esses diretórios:

rm -rf /usr/local/go
rm -rf /etc/paths.d/go

O comando rm remove arquivos ou diretórios. A opção -rf indica remoção recursiva e forçada:

  • r = recursivo: remove a pasta e todas as suas subpastas.

  • f = forçado: ignora confirmações e erros.

Pronto! O Go foi removido do seu Mac. Agora podemos seguir para o download e instalação.

2. Baixar o Go

Há duas formas de baixar o arquivo do Go: manualmente ou pela linha de comando. Vamos ver ambas.

Download manual

O site oficial do Golang possui uma página com links para a versão mais recente da linguagem.

Ali você encontra botões com as versões mais recentes para cada sistema. No nosso caso, buscamos a versão para macOS.

No momento da escrita deste artigo, existem duas versões para macOS: uma para a arquitetura ARM64 dos novos chips da Apple e outra para a arquitetura Intel 64 bits.

Escolha a versão adequada ao seu dispositivo. Os Macs mais novos usam ARM64.

Ao clicar no link, será iniciado o download do arquivo go1.21.3.darwin-amd64.pkg, ou uma versão mais recente.

Download via terminal

Uma alternativa ao download manual é usar a linha de comando.

O macOS inclui uma ferramenta chamada curl, já instalada no sistema.

Portanto, podemos usar o utilitário curl com a URL exata onde está disponível o arquivo do Go:

curl -o golang.pkg https://dl.google.com/go/go1.21.3.darwin-amd64.pkg

O parâmetro -o (--output) garante que o conteúdo recebido será salvo no arquivo golang.pkg.

A URL deve conter o nome exato do arquivo e a versão desejada.

Após a execução do comando, você terá o pacote do Go pronto para instalação.

3. Instalar o pacote Go

Assim como no download, a instalação pode ser feita de duas formas: pela interface gráfica (GUI) ou pela linha de comando.

Instalação pela GUI

Para instalar o Go no macOS pela interface gráfica, basta executar o arquivo golang.pkg que você acabou de baixar.

Após a instalação automática, será exibida uma mensagem de sucesso indicando que o software foi instalado corretamente.

Instalação pela linha de comando

Se preferir usar o terminal, execute o seguinte comando:

sudo open golang.pkg

Depois, siga as instruções na tela até aparecer uma janela confirmando a instalação com sucesso.

4. Configurar variáveis de ambiente

Após a instalação, precisamos informar ao sistema onde encontrar o compilador do Go quando o terminal receber comandos para compilar e executar uma aplicação.

Primeiro, acesse o diretório pessoal com o comando:

cd ~

Agora adicione os caminhos dos componentes do Go ao arquivo .bash_profile. Esse arquivo é carregado automaticamente ao entrar na conta do macOS e contém as configurações de inicialização do terminal.

Você pode adicionar as variáveis de ambiente manualmente ou com os comandos abaixo:

echo "export GOROOT=/usr/local/go" >> .bash_profile
echo "export GOPATH=$HOME/Documents/go" >> .bash_profile
echo "export PATH=$GOPATH/bin:$GOROOT/bin:$PATH" >> .bash_profile

O operador >> garante que o conteúdo entre aspas será acrescentado ao final do arquivo .bash_profile.

A variável GOROOT aponta para o diretório onde o Go foi instalado. A variável GOPATH define o caminho do diretório de trabalho do Go. E a variável PATH garante que os arquivos binários possam ser encontrados durante a compilação.

5. Verificar a instalação

Para garantir que o Go foi instalado corretamente no macOS, reinicie o terminal e execute o comando:

go version

Se tudo estiver certo, você verá a mensagem:

go version go1.21.3 darwin/amd64

6. Executar um aplicativo de teste

Neste artigo, não entraremos nos detalhes da sintaxe do Go nem nas particularidades da linguagem. Vamos apenas escrever, compilar e executar um programa simples com saída no console para verificar se o compilador está funcionando.

Crie um novo arquivo no diretório pessoal com o editor nano:

nano main.go

Adicione o seguinte conteúdo:

package main

import "fmt"

func main() {
     fmt.Println("Hello, World!") // CONCLUSION: Hello, World!
}

Para sair do nano, pressione CTRL+X, depois Y para salvar e ENTER para confirmar.

Agora compile e execute o programa com:

go run main.go

Também existe outro comando que compila o código-fonte da aplicação em um arquivo executável completo que pode ser distribuído e implantado em outras máquinas locais:

go build

Se você não especificar o nome do arquivo .go como argumento, o comando irá compilar o arquivo com o nome padrão main.go.

Por exemplo, se o arquivo que contém nosso programa se chamar test.go, o comando de compilação será:

go build test.go

Durante a compilação, o Go incluirá todos os arquivos .go necessários no build final, adicionando o código auxiliar necessário para que o aplicativo funcione em qualquer máquina com a mesma arquitetura.

Gerar um executável permite rodar o programa em outros computadores mesmo que o compilador do Go não esteja instalado.

Conclusão

Apesar de ser um sistema proprietário, o macOS permite instalar ferramentas de terceiros (como o Go do Google), incluindo soluções de código aberto.

Neste artigo, vimos o processo padrão de instalação do Go no macOS, que inclui:

  • Verificar versões antigas

     

  • Desinstalar versões anteriores, se existirem

     

  • Baixar o pacote (manualmente ou pelo terminal)

     

  • Instalar o pacote (GUI ou linha de comando)

     

  • Configurar variáveis de ambiente

     

  • Verificar a instalação

     

  • Compilar e executar um código simples

Com esses passos, instalamos o Go no macOS e executamos nosso primeiro programa com comandos simples. Para continuar aprendendo, consulte a documentação oficial no site do Golang.

A Hostman também oferece diversos servidores VPS com suporte para macOS a preços acessíveis!

Perguntas frequentes

Como instalar o Go no Mac sem o Homebrew?

Baixe o instalador no site golang.org, execute-o e depois atualize a variável PATH manualmente.

Qual é a maneira mais fácil de instalar o Go no macOS?

Sinceramente? Se você já usa o Homebrew, basta rodar brew install go – é rápido e simples.

Como configurar o PATH para o Go no macOS?

Adicione esta linha ao seu arquivo de configuração do shell: export PATH=$PATH:/usr/local/go/bin

Onde o Go é instalado no macOS?

Geralmente em /usr/local/go ao usar o pacote oficial de instalação.

Linguagem Go
16.07.2025
Reading time: 7 min

Semelhante

Tem perguntas,
comentários ou preocupações?

Nossos profissionais estão disponíveis para ajudá-lo a qualquer momento,
seja para assistência ou apenas se você não souber por onde começar.
Envie-nos um e-mail
Hostman's Support