Resumen de Puntos Clave de las Reglas de Go

Cada punto clave de las 9 páginas de esta sección, reunido en una sola página y agrupado por la página de la que proviene.

Effective Go como Estándar Vivo

• Effective Go es el documento canónico de modismos; las reglas de la comunidad lo operacionalizan
• Automatiza las reglas objetivas (gofmt, vet); mantén las reglas de juicio en la revisión
• Las listas de verificación unen la guía oficial y las decisiones diarias de PR
• Las reglas evolucionan con los lanzamientos: trátalas como vivas, no como ley congelada
• Las bibliotecas y servicios pueden adoptar diferentes niveles de estricción

Guía Rápida de Reglas de Go

• Usa gofmt para eliminar por completo el debate sobre el formato
• Cada retorno de error necesita un manejo explícito de rama
• Envuelve los errores con contexto en los límites de operación
• Siempre pasa context.Context como el primer parámetro
• Acepta interfaces, devuelve siempre tipos concretos
• Documenta los símbolos exportados con godoc obligatorio

Lista de Verificación de Reglas de Effective Go

• Veinticinco modismos numerados de Effective Go y revisión de producción
• Nivel 1: formato, errores, nomenclatura - automatizar en CI
• Nivel 2: APIs, interfaces, pruebas - aplicar en revisión
• Nivel 3: concurrencia y módulos - emparejar con listas de verificación especializadas
• Úsalo como puerta de entrada para la incorporación antes de las páginas de la sección intermedia

Reglas de Diseño de API para Bibliotecas Go

• Los nombres exportados son contratos semver: diseña antes de ampliar la superficie
• context.Context lidera las firmas de IO y RPC
• Los errores se devuelven; los panics se reservan para errores del programador
• Los constructores devuelven interfaces solo cuando el envoltorio es intencional
• Los cambios disruptivos necesitan saltos mayores o nuevas rutas de módulo

Lista de Verificación de Reglas de Concurrencia

• Cada goroutine necesita una ruta de salida probada
• Un propietario cierra cada canal; los receptores nunca cierran
• El orden de los mutex previene interbloqueos - documenta los niveles de bloqueo
• El contexto cancela el trabajo; nunca almacenes Context en structs
• Detector de carreras en CI para paquetes que generan goroutines

Reglas de Módulos y Dependencias

• La directiva go de go.mod coincide con la cadena de herramientas de CI
• Las dependencias mínimas reducen el radio de explosión de CVE y actualizaciones
• internal/ impone límites mejor que solo la nomenclatura
• Las etiquetas Semver son contratos de lanzamiento para bibliotecas
• go mod tidy y las diferencias de go.sum pertenecen a cada PR de módulo

Reglas de Seguridad para Servicios Go

• Los valores predeterminados de TLS no son valores predeterminados de producción: configura MinVersion y certificados
• Los secretos nunca viven en el código fuente, registros o cadenas de error
• Valida y limita toda la entrada externa en los manejadores
• govulncheck y gosec complementan la revisión de código
• Cierra por defecto en errores de autorización

Reglas de Rendimiento: Cuándo Optimizar

• Perfila antes de cambiar el código: los benchmarks mienten sin contexto de carga de trabajo
• La legibilidad es el valor predeterminado; optimiza solo las rutas activas probadas
• Las asignaciones importan más en bucles ajustados y middleware RPC
• La sintonización de GC es el último recurso después de las correcciones de CPU y asignación
• Registra evidencia al omitir una regla de claridad

Resumen de Reglas y Mejores Prácticas de Go

• Envuelve los errores con %w cuando los llamadores inspeccionan centinelas, no mensajes opacos
• Coloca context.Context primero en funciones de IO y RPC, nómbralo ctx
• Acepta interfaces, devuelve tipos concretos de las funciones
• Dale a cada goroutine una ruta de salida ligada al contexto o a WaitGroup
• Ejecuta go test -race en paquetes con goroutines o mapas compartidos
• Valida la entrada externa en los límites usando SQL parametrizado y límites de tamaño