Clean Code en Go: principios y ejemplos para Golang

Clean Code en Go: principios y ejemplos para Golang

El código limpio (Clean Code) no es solo un conjunto de reglas, sino una filosofía de desarrollo que hace que el programa sea comprensible, fácil de mantener y de extender. En el lenguaje Go, creado con énfasis en la simplicidad y la legibilidad, los principios del código limpio son especialmente importantes. En este artículo analizaremos los principios clave de Clean Code aplicados a Go (Golang) y proporcionaremos ejemplos prácticos que le ayudarán a escribir código de mayor calidad.

1. Nombrado de variables, funciones y paquetes

En Go, el nombrado es la base de la legibilidad. Los buenos nombres deben ser cortos pero informativos. Evite abreviaturas que no sean obvias y no use variables de una sola letra (excepto para índices de bucles).

Ejemplo de código malo:

package main

func f(x int) int {    r := x * 2    return r}

Ejemplo de código limpio:

package main

// Double devuelve el valor duplicado de un número.func Double(value int) int {    result := value * 2    return result}

Reglas de nombrado en Go:

• Variables: use camelCase (por ejemplo, userName, itemCount). Para variables globales, use PascalCase si se exportan.
• Funciones: las funciones exportadas comienzan con mayúscula, las no exportadas con minúscula. El nombre debe reflejar la acción (por ejemplo, CalculateSum, parseInput).
• Paquetes: los nombres de los paquetes deben ser cortos, en minúscula y en singular (por ejemplo, fmt, http, strings). Evite nombres genéricos como utils.

2. Manejo de errores y retorno de valores

Go no usa excepciones, sino que devuelve errores como valores. El código limpio requiere una verificación explícita de errores y evitar pánicos (panic) en el flujo normal de ejecución.

Ejemplo de código malo:

func readFile(path string) string {    data, _ := os.ReadFile(path) // Ignorando el error    return string(data)}

Ejemplo de código limpio:

func readFile(path string) (string, error) {    data, err := os.ReadFile(path)    if err != nil {        return "", fmt.Errorf("error al leer el archivo %s: %w", path, err)    }    return string(data), nil}

Recomendaciones para el manejo de errores:

• Siempre verifique los errores devueltos. No use _ para ignorarlos.
• Envuelva los errores usando fmt.Errorf y %w para preservar el contexto.
• No use panic para errores comunes — son situaciones excepcionales (por ejemplo, errores de inicialización).
• Cree tipos de error personalizados si necesita transmitir información adicional.

3. Estructura de funciones y reducción de complejidad

Las funciones en Go deben ser cortas y realizar solo una tarea. Siga el principio de responsabilidad única (Single Responsibility Principle). Si una función se vuelve demasiado larga, divídala en varias funciones auxiliares.

Ejemplo de código malo:

func processOrder(order Order) error {    // 1. Validación    if order.ID == 0 {        return errors.New("ID de pedido inválido")    }    // 2. Cálculo de descuento    discount := 0.0    if order.Amount > 100 {        discount = 0.1    }    // 3. Envío de email    err := sendEmail(order.Email, "Pedido procesado")    if err != nil {        return err    }    // 4. Guardado en BD    err = saveOrder(order)    if err != nil {        return err    }    return nil}

Ejemplo de código limpio:

func processOrder(order Order) error {    if err := validateO