Clean Code en Go: principios y ejemplos para principiantes — parte 1

El código limpio no es solo un término de moda, sino la base de la programación profesional. Si estás aprendiendo Go (Golang) y quieres escribir programas que sean fáciles de leer, mantener y ampliar, los principios de Clean Code serán tu mejor herramienta. En este artículo analizaremos los conceptos básicos del código limpio en Go, que son adecuados incluso para principiantes.

¿Por qué es importante Clean Code en Go?

Go fue diseñado originalmente como un lenguaje para crear soluciones simples y eficientes. Sin embargo, sin seguir las reglas del código limpio, incluso un proyecto simple puede convertirse en un "espagueti". El código limpio ayuda a:

• Reducir la cantidad de errores en la programación;
• Simplificar el trabajo en equipo;
• Reducir el tiempo de aprendizaje para nuevos desarrolladores;
• Mejorar la legibilidad y el mantenimiento del código.

Principio 1: Nomenclatura adecuada

Los nombres de variables, funciones y paquetes deben reflejar su propósito. En Go se acostumbra usar nombres cortos, pero eso no significa que deban carecer de significado.

Ejemplo incorrecto:

func f(a int, b int) int {    r := a + b    return r}

Ejemplo correcto (Clean Code):

func AddNumbers(first int, second int) int {    result := first + second    return result}

Observa: el nombre de la función AddNumbers indica inmediatamente lo que hace. Las variables first, second, result tampoco generan dudas. Esto es especialmente importante para Go para principiantes, ya que los nombres claros aceleran la comprensión del código.

Principio 2: Minimizar el ámbito de visibilidad

En Golang existe el concepto de identificadores exportados (con mayúscula) y no exportados (con minúscula). Úsalos para ocultar los detalles internos de implementación.

Ejemplo:

package calculator

// Función exportadatype Calculator struct {    result int}

func (c *Calculator) Add(value int) {    c.result += value}

func (c *Calculator) GetResult() int {    return c.result}

// Función no exportada — oculta del mundo exteriorfunc (c *Calculator) reset() {    c.result = 0}

Aquí, reset no está disponible desde otros paquetes, lo que protege el estado interno del objeto. Este es uno de los principios clave de Clean Code: la encapsulación.

Principio 3: Las funciones deben ser pequeñas

Una función, una tarea. Si una función hace más de una acción, vale la pena dividirla en varias. Esto mejora la legibilidad y simplifica las pruebas.

Ejemplo incorrecto:

func ProcessUser(name string, age int) string {    if age < 18 {        return "Acceso denegado"    }    result := "Hola, " + name    return result}

Ejemplo correcto (Clean Code):

func IsAdult(age int) bool {    return age >= 18}

func GreetUser(name string) string {    return "Hola, " + name}

func ProcessUser(name string, age int) string {    if !IsAdult(age) {        return "Acceso denegado"    }    return GreetUser(name)}

Ahora cada función se encarga de su parte. Esto facilita el aprendizaje y el mantenimiento del código.

Principio 4: Manejo de errores

En Go no hay excepciones: los errores se devuelven como valores. El código limpio requiere un manejo explícito de errores, no ignorarlos.

Ejemplo incorrecto:

func ReadFile(path string) string {    data, _ := os.ReadFile(path)    return string(data)}

Ejemplo correcto: