Buenas Prácticas de Flujo de Control

Hábitos de control de flujo legibles y cuándo refactorizar la lógica anidada.

Estas reglas mantienen el código Go plano, predecible y seguro bajo concurrencia, desde la disciplina de if err != nil hasta los límites de pánico en servidores.

Cómo Usar Esta Lista

• Aplica durante la revisión de código cuando cadenas if anidadas o manejadores con muchos bucles lleguen a un PR.
• Ejecuta go vet, staticcheck y golangci-lint para detectar automáticamente flujos de control sospechosos.
• Cuando una regla entre en conflicto con datos de benchmark, documenta la excepción con un comentario que enlace el perfil.
• Revisa después de las actualizaciones de Go; la semántica de las variables de bucle cambió en 1.22 y los iteradores se expandieron en 1.23+.

A - Condicionales y salida temprana

• Maneja errores en el punto de llamada con if estilo inicialización. if err := f(); err != nil { return err } supera las rutas de éxito anidadas.
• Retorna temprano en lugar de anidar profundamente. Las cláusulas de guarda para entradas inválidas mantienen la ruta feliz en el margen izquierdo.
• Prefiere switch para la discriminación de múltiples valores sobre una expresión. Las largas cadenas else if sobre la misma variable indican un switch.
• Evita fallthrough a menos que puedas nombrar la razón en un comentario. Los cuerpos de casos compartidos deben llamar a una función auxiliar en su lugar.
• No uses panic para fallos esperados de solicitud o I/O. Retorna error y deja que los llamadores mapeen a estados HTTP/gRPC.

B - Bucles y range

• Por defecto usa for range para slices, mapas, canales y cadenas. Usa bucles de índice cuando necesites vecinos o iteración inversa.
• Nunca dependas del orden de iteración de mapas. Ordena las claves cuando la salida deba ser estable para pruebas o diffs.
• Modifica slices por índice, no por el valor del rango. s[i] = x actualiza la colección; el valor del rango es una copia.
• Pasa variables de bucle a goroutines o parámetros defer en rutas de código antiguas. Las copias defensivas documentan la intención incluso en bibliotecas Go 1.22+.
• Cierra canales desde los remitentes y documenta quién cierra. for range en canales se bloquea si nadie cierra.

C - break, continue, etiquetas y defer

• Usa break label al salir de bucles de búsqueda anidados. Reemplaza pirámides booleanas de found con una etiqueta o return auxiliar.
• Etiqueta break para salir de bucles for { select }. Un break simple solo sale del select, no del bucle.
• Coloca defer inmediatamente después de la adquisición exitosa de recursos. Los lectores emparejan Open/Lock con defer Close/Unlock visualmente.
• Evita defer dentro de bucles ajustados sin una función anidada. Las pilas de defer crecen hasta que la función externa retorna.
• Mantén las funciones diferidas pequeñas y sin pánico. Los pánicos durante la limpieza complican la recuperación y oscurecen la causa raíz.

D - HTTP, middleware y límites de pánico

• Instala middleware de recuperación de pánico en cada servidor HTTP de producción. chi Recoverer, gin Recovery, echo Recover, o defer recover escrito a mano.
• Registra el ID de solicitud, la ruta y la pila en los pánicos recuperados. Los clientes ven 500; los operadores necesitan contexto procesable.
• Corta el middleware con return después de escribir respuestas. Nunca llames a next después de haber completado la respuesta.
• Pasa r.Context() a I/O downstream. El middleware de tiempo de espera solo funciona cuando los manejadores respetan la cancelación.
• Haz defer r.Body.Close() (o equivalente) por solicitud. Los cuerpos filtrados agotan las conexiones bajo carga.

Preguntas Frecuentes

Relacionado

• Diseño Orientado a Expresiones del Flujo de Control en Go - resumen de la sección
• Conceptos Básicos del Flujo de Control - ejemplos introductorios ejecutables
• defer, panic & recover - mecánicas de pánico y defer
• Peligros de Reutilización de Variables en range - errores de captura de bucle
• Flujo de Control en Middleware HTTP - límites de pánico del servidor

Versiones de Stack: Esta página fue escrita para Go 1.26.x (predeterminado Green Tea GC, go fix modernizers - verifica el parche en la compilación), chi (última - verifica en la compilación), gin (última - verifica en la compilación), echo (última - verifica en la compilación), google.golang.org/grpc (última - verifica en la compilación), sigs.k8s.io/controller-runtime (última - verifica en la compilación), kubebuilder (última - verifica en la compilación), tinygo (última - verifica objetivos de placa en la compilación), wazero (última - verifica en la compilación) y golangci-lint (última - verifica el conjunto de linters en la compilación).