Boas Práticas de Fluxo de Controle

Q: Devo sempre usar defer para desbloquear mutex?

Sim para locks de escopo de função - defer mu.Unlock() após Lock() sobrevive a pânicos. Para caminhos quentes dentro de loops, eleve o lock para fora.

Q: Switch com true ainda é aceitável?

switch { case cond: sem tag é a grafia moderna. Mesma semântica, intenção mais clara.

Q: Quais linters ajudam no fluxo de controle?

staticcheck, govet, gosimple e revive sinalizam construções suspeitas. Execute via golangci-lint em CI.

Hábitos de fluxo de controle legíveis e quando refatorar a lógica aninhada.

Essas regras mantêm o código Go plano, previsível e seguro em concorrência - desde a disciplina de if err != nil até os limites de pânico em servidores.

Como Usar Esta Lista

Aplique durante a revisão de código quando cadeias de if aninhadas ou manipuladores com muitos loops chegarem a um PR.
Execute go vet, staticcheck e golangci-lint para capturar fluxos de controle suspeitos automaticamente.
Quando uma regra conflitar com dados de benchmark, documente a exceção com um comentário vinculando o perfil.
Revise após atualizações do Go; a semântica das variáveis de loop mudou em 1.22 e os iteradores foram expandidos em 1.23+.

A - Condicionais e Saída Antecipada

Trate erros no local de chamada com if estilo init. if err := f(); err != nil { return err } é melhor que caminhos de sucesso aninhados.
Retorne cedo em vez de aninhamento profundo. Cláusulas de guarda para entrada inválida mantêm o caminho feliz na margem esquerda.
Prefira switch para discriminação de múltiplos valores em uma expressão. Longas cadeias de else if na mesma variável sinalizam um switch.
Evite fallthrough a menos que você possa nomear o motivo em um comentário. Corpos de caso compartilhados devem chamar uma função auxiliar em vez disso.
Não use panic para falhas esperadas de requisição ou I/O. Retorne error e deixe os chamadores mapearem para status HTTP/gRPC.

B - Loops e Range

Use for range por padrão para slices, mapas, canais e strings. Use loops de índice quando precisar de vizinhos ou iteração reversa.
Nunca dependa da ordem de iteração de mapas. Ordene as chaves quando a saída precisar ser estável para testes ou diffs.
Mutate slices por índice, não pelo valor do range. s[i] = x atualiza a coleção; o valor do range é uma cópia.
Passe variáveis de loop para goroutines ou parâmetros defer em caminhos de código mais antigos. Cópias defensivas documentam a intenção mesmo em bibliotecas Go 1.22+.
Feche canais dos remetentes e documente quem fecha. for range em canais causa deadlock quando ninguém fecha.

C - break, continue, labels e defer

Use break label ao sair de loops de busca aninhados. Substitua pirâmides booleanas found por um rótulo ou return auxiliar.
Use break label para sair de loops for { select }. break simples apenas sai do select, não do loop.
Coloque defer imediatamente após a aquisição bem-sucedida do recurso. Leitores associam Open/Lock com defer Close/Unlock visualmente.
Evite defer dentro de loops apertados sem uma função aninhada. Pilhas de defer crescem até que a função externa retorne.
Mantenha funções defer minúsculas e sem pânico. Pânicos durante o desenrolamento complicam a recuperação e obscurecem a causa raiz.

D - HTTP, Middleware e Limites de Pânico

Instale middleware de recuperação de pânico em todos os servidores HTTP de produção. Recoverer do chi, Recovery do gin, Recover do echo, ou defer recover escrito à mão.
Registre o ID da requisição, caminho e stack em pânicos recuperados. Clientes veem 500; operadores precisam de contexto acionável.
Interrompa o middleware com return após escrever as respostas. Nunca chame next depois de ter finalizado a resposta.
Passe r.Context() para I/O downstream. Middleware de timeout só funciona quando os manipuladores respeitam o cancelamento.
Defer r.Body.Close() (ou equivalente) por requisição. Corpos vazados esgotam conexões sob carga.

FAQs

Quão profundo deve ir o aninhamento de if?

Raramente mais de dois níveis em código de aplicação.

Extraia funções ou use cláusulas de guarda quando mais profundo.

Quando um break rotulado é melhor que uma função auxiliar?

Quando um loop duplo apertado se beneficiaria de uma chamada extra e o rótulo nomeia claramente o destino de saída.

Se a lógica crescer além disso, extraia.

Devo sempre usar defer para desbloquear mutex?

Sim para locks de escopo de função - defer mu.Unlock() após Lock() sobrevive a pânicos.

Para caminhos quentes dentro de loops, eleve o lock para fora.

Switch com true ainda é aceitável?

switch { case cond: sem tag é a grafia moderna.

Mesma semântica, intenção mais clara.

Preciso de recover em todos os manipuladores?

Não - um middleware de recuperação envolvendo a árvore é suficiente.

Camadas duplicadas são redundantes, não prejudiciais.

Quando devo refatorar um loop for para uma função?

Quando o corpo excede uma tela, precisa de múltiplas saídas ou se repete em testes.

Funções nomeadas melhoram rastros de pilha e testes unitários.

Instruções goto são aceitáveis alguma vez?

Quase nunca em código de aplicação.

Prefira rótulos, auxiliares ou tabelas de despacho orientadas a dados.

Como mantenho exclusões de range de mapa seguras?

Excluir a chave atual durante a iteração é definido.

Mantenha a lógica de exclusão simples; extraia as chaves primeiro se tiver dúvidas.

Bibliotecas devem entrar em pânico com entrada inválida?

Prefira erros para chamadores que podem reagir.

Reserve o pânico para uso indevido documentado que deve falhar em desenvolvimento.

Quais linters ajudam no fluxo de controle?

staticcheck, govet, gosimple e revive sinalizam construções suspeitas.

Execute via golangci-lint em CI.

Relacionado

Go Control Flow: Expression-Oriented Design - visão geral da seção
Control Flow Basics - exemplos executáveis de introdução
defer, panic & recover - mecânica de pânico e defer
range Variable Reuse Pitfalls - bugs de captura de loop
Control Flow in HTTP Middleware - limites de pânico do servidor

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

Boas Práticas de Fluxo de Controle

Hábitos de fluxo de controle legíveis e quando refatorar a lógica aninhada.

Essas regras mantêm o código Go plano, previsível e seguro em concorrência - desde a disciplina de if err != nil até os limites de pânico em servidores.

Como Usar Esta Lista

Aplique durante a revisão de código quando cadeias de if aninhadas ou manipuladores com muitos loops chegarem a um PR.
Execute go vet, staticcheck e golangci-lint para capturar fluxos de controle suspeitos automaticamente.
Quando uma regra conflitar com dados de benchmark, documente a exceção com um comentário vinculando o perfil.
Revise após atualizações do Go; a semântica das variáveis de loop mudou em 1.22 e os iteradores foram expandidos em 1.23+.

A - Condicionais e Saída Antecipada

Trate erros no local de chamada com if estilo init. if err := f(); err != nil { return err } é melhor que caminhos de sucesso aninhados.
Retorne cedo em vez de aninhamento profundo. Cláusulas de guarda para entrada inválida mantêm o caminho feliz na margem esquerda.
Prefira switch para discriminação de múltiplos valores em uma expressão. Longas cadeias de else if na mesma variável sinalizam um switch.
Evite fallthrough a menos que você possa nomear o motivo em um comentário. Corpos de caso compartilhados devem chamar uma função auxiliar em vez disso.
Não use panic para falhas esperadas de requisição ou I/O. Retorne error e deixe os chamadores mapearem para status HTTP/gRPC.

B - Loops e Range

Use for range por padrão para slices, mapas, canais e strings. Use loops de índice quando precisar de vizinhos ou iteração reversa.
Nunca dependa da ordem de iteração de mapas. Ordene as chaves quando a saída precisar ser estável para testes ou diffs.
Mutate slices por índice, não pelo valor do range. s[i] = x atualiza a coleção; o valor do range é uma cópia.
Passe variáveis de loop para goroutines ou parâmetros defer em caminhos de código mais antigos. Cópias defensivas documentam a intenção mesmo em bibliotecas Go 1.22+.
Feche canais dos remetentes e documente quem fecha. for range em canais causa deadlock quando ninguém fecha.

C - break, continue, labels e defer

Use break label ao sair de loops de busca aninhados. Substitua pirâmides booleanas found por um rótulo ou return auxiliar.
Use break label para sair de loops for { select }. break simples apenas sai do select, não do loop.
Coloque defer imediatamente após a aquisição bem-sucedida do recurso. Leitores associam Open/Lock com defer Close/Unlock visualmente.
Evite defer dentro de loops apertados sem uma função aninhada. Pilhas de defer crescem até que a função externa retorne.
Mantenha funções defer minúsculas e sem pânico. Pânicos durante o desenrolamento complicam a recuperação e obscurecem a causa raiz.

D - HTTP, Middleware e Limites de Pânico

Instale middleware de recuperação de pânico em todos os servidores HTTP de produção. Recoverer do chi, Recovery do gin, Recover do echo, ou defer recover escrito à mão.
Registre o ID da requisição, caminho e stack em pânicos recuperados. Clientes veem 500; operadores precisam de contexto acionável.
Interrompa o middleware com return após escrever as respostas. Nunca chame next depois de ter finalizado a resposta.
Passe r.Context() para I/O downstream. Middleware de timeout só funciona quando os manipuladores respeitam o cancelamento.
Defer r.Body.Close() (ou equivalente) por requisição. Corpos vazados esgotam conexões sob carga.

FAQs

Quão profundo deve ir o aninhamento de if?

Raramente mais de dois níveis em código de aplicação.

Extraia funções ou use cláusulas de guarda quando mais profundo.

Quando um break rotulado é melhor que uma função auxiliar?

Quando um loop duplo apertado se beneficiaria de uma chamada extra e o rótulo nomeia claramente o destino de saída.

Se a lógica crescer além disso, extraia.

Devo sempre usar defer para desbloquear mutex?

Sim para locks de escopo de função - defer mu.Unlock() após Lock() sobrevive a pânicos.

Para caminhos quentes dentro de loops, eleve o lock para fora.

Switch com true ainda é aceitável?

switch { case cond: sem tag é a grafia moderna.

Mesma semântica, intenção mais clara.

Preciso de recover em todos os manipuladores?

Não - um middleware de recuperação envolvendo a árvore é suficiente.

Camadas duplicadas são redundantes, não prejudiciais.

Quando devo refatorar um loop for para uma função?

Quando o corpo excede uma tela, precisa de múltiplas saídas ou se repete em testes.

Funções nomeadas melhoram rastros de pilha e testes unitários.

Instruções goto são aceitáveis alguma vez?

Quase nunca em código de aplicação.

Prefira rótulos, auxiliares ou tabelas de despacho orientadas a dados.

Como mantenho exclusões de range de mapa seguras?

Excluir a chave atual durante a iteração é definido.

Mantenha a lógica de exclusão simples; extraia as chaves primeiro se tiver dúvidas.

Bibliotecas devem entrar em pânico com entrada inválida?

Prefira erros para chamadores que podem reagir.

Reserve o pânico para uso indevido documentado que deve falhar em desenvolvimento.

Quais linters ajudam no fluxo de controle?

staticcheck, govet, gosimple e revive sinalizam construções suspeitas.

Execute via golangci-lint em CI.

Relacionado

Go Control Flow: Expression-Oriented Design - visão geral da seção
Control Flow Basics - exemplos executáveis de introdução
defer, panic & recover - mecânica de pânico e defer
range Variable Reuse Pitfalls - bugs de captura de loop
Control Flow in HTTP Middleware - limites de pânico do servidor

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

Boas Práticas de Fluxo de Controle

Buscar na documentação

Boas Práticas de Fluxo de Controle