Código limpio en Swift: principios y ejemplos para iOS/macOS

Clean Code en Swift: principios y ejemplos prácticos

El código limpio (Clean Code) no es solo un término de moda, sino una habilidad fundamental para todo desarrollador que trabaja con Swift para iOS y macOS. En el mundo del ecosistema Apple, donde los proyectos suelen durar años y son mantenidos por diferentes equipos, la capacidad de escribir código comprensible, predecible y fácilmente modificable impacta directamente en la velocidad de desarrollo y la cantidad de errores. En este artículo, analizaremos los principios clave de Clean Code en Swift con ejemplos concretos que podrá aplicar en sus proyectos desde hoy.

¿Por qué es importante Clean Code para el desarrollador de Swift?

Swift es un lenguaje potente y expresivo, pero su flexibilidad puede llevar al caos si no se mantiene la disciplina. El código limpio resuelve tres problemas principales:

• Legibilidad: Otro desarrollador (o usted mismo dentro de un mes) debe entender el código sin esfuerzo.
• Mantenibilidad: Agregar nuevas funcionalidades no debe romper la lógica existente.
• Capacidad de prueba: El código limpio se cubre fácilmente con pruebas unitarias.

Pasemos de la teoría a la práctica y revisemos los principios fundamentales.

Principio 1: La nomenclatura es la base de la limpieza

Un buen nombre de variable, función o clase habla por sí mismo. En Swift, con su tipado estricto, esto es especialmente importante. Evite abreviaturas y nombres de una sola letra (excepto en bucles).

Mal:

func calc(a: Int, b: Int) -> Int {    return a * b}

Bien:

func calculateArea(width: Int, height: Int) -> Int {    return width * height}

Regla para Swift: Use CamelCase para variables y funciones. Los nombres deben responder a las preguntas "¿Qué es esto?" o "¿Qué hace?".

• Variable: userName, maxRetryCount
• Función: fetchData(), validateEmail()
• Clase/Estructura: UserProfile, NetworkService

Principio 2: Funciones pequeñas (Responsabilidad Única)

Cada función debe hacer solo una cosa. Si una función ocupa más de 10-15 líneas o tiene comentarios que explican bloques de código, es una señal para refactorizar. En Swift, esto es especialmente relevante debido al uso de closures y el enfoque funcional.

Ejemplo de violación (un método grande):

func processUserData(user: User) {    // Validación    guard user.email.contains("@") else { return }    // Guardado en BD    Database.shared.save(user)    // Envío de notificación    NotificationCenter.default.post(name: .userSaved, object: nil)}

Código limpio (separación de responsabilidades):

func processUserData(user: User) {    guard validateUser(user) else { return }    saveUser(user)    notifyUserSaved()}

private func validateUser(_ user: User) -> Bool {    return user.email.contains("@")}

private func saveUser(_ user: User) {    Database.shared.save(user)}

private func notifyUserSaved() {    NotificationCenter.default.post(name: .userSaved, object: nil)}

Ahora cada función es fácil de probar, modificar y reutilizar.

Principio 3: Evite números y cadenas mágicas

Los valores codificados ("números mágicos") son enemigos de la legibilidad. En Swift, use constantes y enumeraciones (enum).

Mal:

if user.age > 18 {    grantAccess()}

Bien:

private let minimumAgeForAccess = 18

if user.age > minimumAgeForAccess {    grantAccess()}

Para casos más complejos, use enum:

enum HTTPStatusCode: Int {    case ok = 200    case notFound = 404    case internalError = 500}

func handleResponse(code: Int) {    sw