Hello, World e a toolchain: go run, go build e go mod sem mistério

Código anotado

Vamos escrever o programa que acompanha essa conversa: um “Hello, World” que se apresenta e mostra em qual sistema e arquitetura foi compilado — a mesma informação que os comandos da toolchain usam para gerar binários para cada plataforma.

O início você já conhece da aula passada: pacote executável e imports. A novidade é importar dois pacotes: a lista entre parênteses é a forma idiomática quando há mais de um. runtime expõe informações sobre o ambiente em que o programa está rodando.

package main

import (
	"fmt"
	"runtime"
)

runtime.GOOS e runtime.GOARCH são constantes gravadas no momento da compilação: o sistema operacional alvo (linux, darwin, windows, js…) e a arquitetura de processador (amd64, arm64, wasm…). Elas não descobrem nada em tempo de execução — o compilador as fixa ao gerar o binário. Um binário compilado para Linux dirá linux para sempre, em qualquer lugar.

// platform descreve o alvo de compilação deste binário.
func platform() string {
	return runtime.GOOS + "/" + runtime.GOARCH
}

O main imprime a apresentação. Rode e repare na saída: aqui no curso ela será js/wasm, porque o compilador que roda no seu navegador gera WebAssembly. O mesmo programa, compilado no seu notebook, diria darwin/arm64 ou linux/amd64. Um código, muitos alvos — esse é o mecanismo por trás da cross-compilation que você vai exercitar adiante.

func main() {
	fmt.Println("Hello, World!")
	fmt.Println("Compilado para:", platform())
}

Agora, o caminho que esse código percorre fora do navegador. Suponha o arquivo salvo como hello.go em um diretório vazio. O fluxo de trabalho real tem três passos, e cada um responde uma pergunta diferente.

Passo 1 — dar identidade ao projeto. Todo projeto Go moderno é um módulo: um diretório com um arquivo go.mod na raiz. O comando go mod init github.com/maria/hello cria esse arquivo com duas linhas: o caminho do módulo e a versão de Go. O caminho segue a convenção host/usuário/repositório porque ele é, ao mesmo tempo, o endereço de importação: se outro projeto quiser usar seu código, importa por esse nome. Para experimentos locais um nome curto funciona, mas o hábito da convenção não custa nada e evita renomear depois.

Passo 2 — rodar durante o desenvolvimento. go run hello.go compila o programa para um local temporário, executa e descarta o binário. É o ciclo rápido: editar, go run, olhar a saída, repetir. Nada fica para trás no diretório.

Passo 3 — construir para entregar. go build compila e grava o binário no diretório atual — hello (ou hello.exe no Windows). Esse arquivo é autônomo: copie-o para outra máquina do mesmo sistema/arquitetura e ele roda, sem Go instalado. A diferença entre go run e go build é só o destino do binário; a compilação é a mesma.

E o truque que fecha o raciocínio: as constantes GOOS e GOARCH que o programa imprime são configuráveis na compilação. GOOS=linux GOARCH=amd64 go build — rodado do seu Mac — produz um binário de Linux, pronto para o servidor. Nenhuma máquina virtual, nenhum toolchain extra: cross-compilation é parte do compilador padrão.