Resumo dos Destaques das Regras Go

Cada item destacado das 9 páginas desta seção, reunido em uma página e agrupado pela página de origem.

Effective Go como um Padrão Vivo

• Effective Go é o documento canônico de idiomática; as regras da comunidade operacionalizam isso
• Automatize regras objetivas (gofmt, vet); mantenha regras de julgamento na revisão
• Checklists conectam a orientação oficial e as decisões diárias de PR
• As regras evoluem com os lançamentos - trate-as como vivas, não como lei congelada
• Bibliotecas e serviços podem adotar diferentes níveis de rigor

Guia Rápido das Regras Go

• Use gofmt para eliminar completamente o debate de formatação
• Cada retorno de erro precisa de tratamento explícito de branch
• Envolva erros com contexto nos limites da operação
• Sempre passe context.Context como o primeiro parâmetro
• Aceite interfaces, retorne sempre tipos concretos
• Documente símbolos exportados com godoc obrigatório

Checklist das Regras Effective Go

• Vinte e cinco idiomas numerados de Effective Go e revisão de produção
• Nível 1: formatação, erros, nomenclatura - automatize em CI
• Nível 2: APIs, interfaces, testes - imponha na revisão
• Nível 3: concorrência e módulos - combine com checklists especializados
• Use como portão de integração antes das páginas da seção intermediária

Regras de Design de API para Bibliotecas Go

• Nomes exportados são contratos semver - projete antes de alargar a superfície
• context.Context lidera assinaturas de IO e RPC
• Erros retornam; panics permanecem para bugs de programador
• Construtores retornam interfaces apenas quando o wrapping é intencional
• Mudanças de quebra precisam de bumps maiores ou novos caminhos de módulo

Checklist de Regras de Concorrência

• Cada goroutine precisa de um caminho de saída comprovado
• Um proprietário fecha cada canal; receptores nunca fecham
• A ordenação de Mutex previne deadlocks - documente os níveis de lock
• Contexto cancela o trabalho; nunca armazene Context em structs
• Detector de race em CI para pacotes que criam goroutines

Regras de Módulo e Dependência

• A diretiva go do go.mod corresponde à toolchain de CI
• Dependências mínimas reduzem o raio de explosão de CVE e atualizações
• internal/ impõe limites melhor do que apenas a nomenclatura
• Tags Semver são contratos de lançamento para bibliotecas
• go mod tidy e diffs de go.sum pertencem a cada PR de módulo

Regras de Segurança para Serviços Go

• Os padrões TLS não são padrões de produção - configure MinVersion e certificados
• Segredos nunca vivem em código-fonte, logs ou strings de erro
• Valide e limite toda entrada externa nos manipuladores
• govulncheck e gosec complementam a revisão de código
• Feche em caso de erros de autorização

Regras de Desempenho: Quando Otimizar

• Perfilar antes de alterar o código - benchmarks mentem sem contexto de carga de trabalho
• Legibilidade é o padrão; otimize apenas os caminhos quentes comprovados
• Alocações importam mais em loops apertados e middleware RPC
• Ajuste de GC é o último recurso após correções de CPU e alocação
• Registre evidências ao contornar uma regra de clareza

Resumo de Regras e Melhores Práticas Go

• Envolva erros com %w quando os chamadores inspecionarem sentinelas, não mensagens opacas
• Coloque context.Context primeiro em funções de IO e RPC, nomeie-o ctx
• Aceite interfaces, retorne tipos concretos de funções
• Dê a cada goroutine um caminho de saída ligado ao contexto ou WaitGroup
• Execute go test -race em pacotes com goroutines ou mapas compartilhados
• Valide a entrada externa nos limites usando SQL parametrizado e limites de tamanho