SwiftLint para Swift: guía completa con ejemplos prácticos

1. ¿Qué es SwiftLint y para qué sirve?

SwiftLint es una herramienta de análisis estático de código (linter) para el lenguaje de programación Swift. Revisa automáticamente tu código para verificar que cumpla con un conjunto de reglas basadas en la Swift Style Guide (guía de estilo de Apple) y las mejores prácticas de la comunidad. Imagínalo como un «revisor inteligente» que trabaja en tiempo real dentro de tu editor, resaltando posibles problemas, violaciones de formato y errores lógicos.

¿Para qué sirve? En proyectos grandes, donde decenas de desarrolladores trabajan sobre la misma base de código, mantener un estilo uniforme es fundamental. SwiftLint resuelve este problema de forma automática. No solo te ayuda a escribir código más limpio y legible, sino que también previene errores comunes en etapas tempranas. Por ejemplo, puede advertirte sobre el uso de APIs obsoletas (deprecated), funciones demasiado complejas que son difíciles de probar, o una mala indentación.

Integrar SwiftLint en tu flujo de desarrollo (CI/CD) permite rechazar automáticamente Pull Requests que no cumplan con los estándares de calidad, ahorrando tiempo en las revisiones de código y mejorando la estabilidad general del proyecto. Es una herramienta imprescindible para cualquier equipo profesional de desarrollo iOS/macOS.

2. Instalación

SwiftLint se puede instalar de varias formas. La más popular y recomendada es a través de Homebrew (el gestor de paquetes para macOS).

Opción 1: Homebrew (Recomendada)

Abre la terminal y ejecuta el comando:

brew install swiftlint

Opción 2: CocoaPods

Si usas CocoaPods, agrega esto a tu Podfile:

pod 'SwiftLint'

Luego ejecuta:

pod install

Opción 3: Swift Package Manager (SPM)

Añade el paquete a tu Package.swift:

dependencies: [
    .package(url: "https://github.com/realm/SwiftLint.git", from: "0.54.0")
]

Opción 4: Mint

Si usas Mint:

mint install realm/SwiftLint

3. Inicio rápido: ejemplo mínimo funcional

Después de instalar, la forma más sencilla de probar SwiftLint es ejecutarlo desde la terminal en la carpeta raíz de tu proyecto.

1. Crea un nuevo archivo Swift llamado ejemplo.swift con código «malo»:

// ejemplo.swift
import Foundation

let x = 10
let y = 20
func suma(a:Int, b:Int)->Int {
return a + b
}
print(suma(a: x, b: y))

2. Ejecuta el linter:

swiftlint lint --path ejemplo.swift

Verás en la terminal algo como:

ejemplo.swift:3:1: warning: Colon Violation (colon) - Los dos puntos deben estar junto al identificador al especificar un tipo y junto a la clave en literales de diccionario.
ejemplo.swift:5:1: warning: Vertical Whitespace Violation (vertical_whitespace) - Limita el espacio vertical a una sola línea vacía.
ejemplo.swift:5:16: warning: Colon Violation (colon) - Los dos puntos deben estar junto al identificador al especificar un tipo.
ejemplo.swift:6:1: warning: Return Arrow Whitespace Violation (return_arrow_whitespace) - El archivo debe tener una sola nueva línea al final.
...

SwiftLint ha encontrado violaciones de estilo. Ahora corrige el código siguiendo las sugerencias:

// ejemplo.swift (corregido)
import Foundation

let x = 10
let y = 20

func suma(a: Int, b: Int) -> Int {
    return a + b
}

print(suma(a: x, b: y))

Vuelve a ejecutar el linter — esta vez no habrá advertencias.

4