Noções Básicas da Toolchain Go

10 exemplos para você começar com a Toolchain Go - 7 básicos e 3 intermediários.

Pré-requisitos

• Instale o Go 1.26.x ou posterior em go.dev/dl.
• Crie um módulo: mkdir tooldemo && cd tooldemo && go mod init example.com/tooldemo.
• Salve os trechos de shell na raiz do módulo, a menos que um caminho seja mostrado.

Exemplos Básicos

1. Verificar a versão da toolchain

Confirme qual release do Go está ativa antes de depurar diferenças de build.

go version

• Imprime a versão do compilador e o sistema operacional/arquitetura de destino.
• Compare a saída entre o laptop e o CI quando os builds divergem.
• go env GOVERSION imprime apenas a string da versão para scripts.

Relacionado: O Comando go: Ciclo de Vida de Build, Teste e Módulos - como o driver se encaixa

2. Compilar um binário

Compile o pacote atual sem instalar globalmente.

go build -o bin/server ./cmd/server

• go build sem -o nomeia o binário com o nome do diretório (server para cmd/server).
• O comando sai com status diferente de zero em erros de compilação; scripts devem verificar $?.
• Adicione -trimpath em pipelines de release para remover caminhos de arquivo dos binários.

Relacionado: go build, run, install & clean - flags e comportamento do cache

3. Executar a partir do código-fonte

Compile para um binário temporário e execute em uma única etapa.

go run .

• Ideal para desenvolvimento local; não para implantação em produção.
• Passe argumentos após --: go run . --port 8080.
• go run ./cmd/worker visa um pacote main específico.

Relacionado: go build, run, install & clean - quando preferir build em vez de run

4. Testar um pacote

Execute testes no diretório atual.

go test -v .

• -v imprime o nome de cada teste à medida que ele é executado.
• Testes residem em arquivos *_test.go ao lado do código de produção.
• Testes com falha saem com status 1, que o CI deve tratar como um gate rígido.

Relacionado: go test, list & generate - padrões, race e benchmarks

5. Testar todos os pacotes recursivamente

Execute toda a árvore de módulos.

go test ./...

• ./... expande para todos os pacotes sob a raiz do módulo.
• Adicione -count=1 para desativar o cache de resultados de teste ao depurar flakes.
• Combine com -race no CI para detecção de data race.

Relacionado: go test, list & generate - -race, -cover e benchmarks

6. Inicializar e inspecionar módulos

go mod init cria o arquivo raiz do módulo.

go mod init example.com/tooldemo
cat go.mod

• O caminho do módulo deve corresponder ao caminho de hospedagem do seu VCS quando você publicar.
• go 1.26 em go.mod declara a versão mínima da linguagem.
• Um go.mod por raiz de módulo; subpacotes o compartilham.

Relacionado: go mod tidy, vendor, download & graph - mantendo as dependências precisas

7. Organizar dependências do módulo

Sincroniza go.mod com as importações reais.

go mod tidy

• Adiciona linhas require ausentes e remove módulos não utilizados.
• Atualiza as linhas de checksum go.sum para cada módulo retido.
• Execute após refatorações que adicionam ou removem importações de terceiros.

Relacionado: go mod tidy, vendor, download & graph - comandos vendor e graph

Exemplos Intermediários

8. Verificação estática com go vet

Detecta construções suspeitas que o compilador permite.

go vet ./...

• Executa analisadores como código inalcançável e verbos fmt mal utilizados.
• Compartilha o verificador de tipos com go test, então ele compila os pacotes primeiro.
• Emparelhe com golangci-lint no CI para conjuntos de regras mais amplos.

Relacionado: go fix Modernizers & go vet Analyzers - correções e analisadores personalizados

9. Listar pacotes e versões de módulos

Inspecione o que o carregador vê antes de um build.

go list ./...
go list -m -versions golang.org/x/sync

• go list imprime caminhos de importação, status de teste e tags de build aplicadas.
• -m muda para o modo de módulo para consultas de versão.
• Use go list -m all para despejar a lista completa de builds para auditorias.

Relacionado: go test, list & generate - saída JSON e templates -f

10. Fixar ou alternar a toolchain com GOTOOLCHAIN

Controle qual release do Go executa os comandos.

go env GOTOOLCHAIN
GOTOOLCHAIN=go1.26.0 go version

• O padrão auto pode baixar um patch mais recente que satisfaça go.mod.
• GOTOOLCHAIN=local proíbe downloads automáticos da toolchain.
• Confirme a diretiva go em go.mod para que os colegas resolvam a mesma linha de base.

Relacionado: Cross-Compilation & Private Module Proxies - variáveis de ambiente para builds e módulos

Versões da Stack: Esta página foi escrita para Go 1.26.x (padrão Green Tea GC, modernizadores go fix - verifique o patch no build), chi (última versão - verifique no build), gin (última versão - verifique no build), echo (última versão - verifique no build), google.golang.org/grpc (última versão - verifique no build), sigs.k8s.io/controller-runtime (última versão - verifique no build), kubebuilder (última versão - verifique no build), tinygo (última versão - verifique os alvos de placa no build), wazero (última versão - verifique no build) e golangci-lint (última versão - verifique o conjunto de linters no build).