Idiomas y Trampas Comunes

Patrones y escollos que toda base de código Go encuentra. Los resultados aparecen en la misma valla: comentarios // en la misma línea cuando son cortos, bloques // multilínea debajo de la muestra cuando no lo son.

Aceptar Interfaces

Las funciones aceptan interfaces, retornan tipos concretos.

// func Save(s Store) error

Copiar al Retornar

Copia los slices antes de retornar el estado interno.

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

Variable de Bucle

Variables por iteración en Go 1.22+.

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

JSON de Slice Nil

Un slice nil se codifica como null; uno vacío se codifica como [].

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

Fuga de Goroutine

Proporciona siempre una ruta de salida.

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

Defer en Bucle

defer se ejecuta al final de la función; envuelve los cuerpos de los bucles.

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

Opciones Funcionales

Configuración opcional mediante opciones.

// type Option func(*Server)

Tiempos de Espera de Red

Establece siempre tiempos de espera para el cliente/servidor HTTP.

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

API No Panic

Retorna error desde APIs públicas.

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

Parámetro de Contexto

Pasa ctx a los métodos en cada llamada.

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

Mutex No Copiar

Nunca copies un Mutex; compártelo por puntero.

// type S struct { mu sync.Mutex }

Orden de Rango de Mapas

El orden de iteración de los mapas se aleatoriza.

// no confíes en el orden de iteración de los mapas

Reintentar Idempotente

Reintenta solo operaciones idempotentes con retroceso exponencial.

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

go generate

Generación de código como un paso de primera clase.

// //go:generate mockgen ...

Errores, No Cadenas

Ramifica con errors.Is/As, no con strings.Contains.

// errors.Is(err, ErrNotFound)

Relacionado

• Goroutines de Concurrencia - prevención de fugas
• Interfaces y Genéricos - diseño de interfaces
• Manejo de Errores - idiomas de manejo de errores

Enlaces Externos Relacionados

• Effective Go - Guía oficial para escribir Go claro e idiomático.
• Go Wiki – Learn - Recursos de aprendizaje curados por la comunidad.
• Stack Overflow – Tag Go - Preguntas y respuestas para programación Go.
• Learning Go (2nd Edition) - Jon Bodner.
• Concurrency in Go - Katherine Cox-Buday.

Versiones de Stack: Go 1.26.x · chi/gin/echo latest (verificar en la compilación)