Idiomas e Armadilhas

Padrões e armadilhas que toda base de código Go encontra. Os resultados aparecem na mesma seção de código: comentários // na mesma linha quando curtos, blocos // de várias linhas abaixo da amostra quando não.

Aceitar Interfaces

Funções aceitam interfaces, retornam tipos concretos.

// func Salvar(s Store) error

Copiar na Retorno

Copie slices antes de retornar o estado interno.

// out := make([]T, len(in)); copy(out, in); return out

Variável de Loop

Variáveis por iteração no Go 1.22+.

// for _, v := range xs { go f(v) } // ok no 1.22+

JSON de Slice Nil

Slice nil codifica como null; vazio codifica como [].

b, _ := json.Marshal([]int(nil))
string(b)  // "null"

Vazamento de Goroutine

Sempre forneça um caminho de saída.

// select { case <-ctx.Done(): return; case ch <- v: }

Defer em Loop

defer executa no final da função - envolva os corpos do loop.

// for ... { func(){ defer f.Close(); ... }() }

Opções Funcionais

Configuração opcional via opções.

// type Option func(*Server)

Timeouts de Rede

Sempre defina timeouts do cliente/servidor HTTP.

// &http.Client{Timeout: 10 * time.Second}

API Não Usar Panic

Retorne erro de APIs públicas.

// if id == "" { return fmt.Errorf("id required") }

Parâmetro Contexto

Passe ctx para métodos a cada chamada.

// func (s *Svc) Get(ctx context.Context, id string)

Mutex Não Copiar

Nunca copie um Mutex - compartilhe por ponteiro.

// type S struct { mu sync.Mutex }

Ordem de Iteração de Map

A ordem de iteração de Map é aleatória.

// não confie na ordem de iteração de map

Retentar Idempotente

Retente apenas operações idempotentes com backoff.

// if temporary(err) { sleep; retry }

go generate

Geração de código como um passo de primeira classe.

// //go:generate mockgen ...

Erros Não Strings

Ramifique com errors.Is/As, não com strings.Contains.

// errors.Is(err, ErrNotFound)

Relacionado

• Goroutines de Concorrência - prevenção de vazamentos
• Interfaces e Genéricos - design de interface
• Tratamento de Erros - idiomas de erro

Links Externos Relacionados

• Effective Go - Guia oficial para escrever Go claro e idiomático.
• Go Wiki – Aprender - Recursos de aprendizado curados pela comunidade.
• Stack Overflow – Tag Go - Perguntas e respostas para programação Go.
• Learning Go (2nd Edition) - Jon Bodner.
• Concurrency in Go - Katherine Cox-Buday.

Versões da Pilha: Go 1.26.x · chi/gin/echo mais recente (verificar na compilação)