Loading…

Acerca de Formateador Swift en Línea

Escribir Swift que **compile** es fácil. Escribir Swift que sea **bonito, consistente y listo para revisión** es más difícil. Este formateador Swift en línea utiliza reglas al estilo SwiftFormat para normalizar la sangría, el espaciado y el ajuste de línea, de modo que tus archivos `.swift` se mantengan limpios en Xcode, Swift Playgrounds y tuberías de CI.

Características Principales del Formateador Swift

  • **Limpieza con un clic** de la sangría, espaciado y llaves en el código Swift
  • **Tamaño de sangría configurable** mediante el control deslizante *Tamaño de Sangría* (1–8 espacios)
  • Control de **Ajuste / Longitud de Línea** para mantener expresiones largas dentro de tu ancho de columna preferido
  • Admite archivos fuente `.swift` estándar y fragmentos pegados
  • Ideal para proyectos **iOS, macOS, watchOS, tvOS y Swift del lado del servidor**
  • Utiliza un motor estilo SwiftFormat detrás de escena para una salida Swift idiomática
  • Formateo idempotente – ejecutarlo múltiples veces mantiene la misma salida
  • No se requiere cuenta – solo pega, formatea y copia el resultado limpio

🛠️ Cómo Usar el Formateador Swift for swift-formatter

1

1. Pega o Sube Tu Código Swift

📥 Pega el código Swift directamente en el editor, o arrastra y suelta un archivo `.swift`. La herramienta está optimizada para fuentes Swift típicas estilo Xcode.

2

2. Configura la Indentación y Longitud de Línea

📏 Usa el control deslizante **Tamaño de Indentación** para elegir cuántos espacios debe usar cada nivel de indentación, y configura **Ajuste / Longitud de Línea** para controlar dónde se deben ajustar las líneas largas (o configúralo en `0` para desactivar el formateo basado en ajuste).

3

3. Haz Clic en "Formatear"

⚡ Presiona el botón **Formatear** para aplicar las reglas estilo SwiftFormat. El formateador normaliza la indentación, espacios alrededor de `:` y operadores, y ajusta líneas largas según tus configuraciones.

4

4. Revisa y Copia el Resultado

🔍 Compara las versiones original y formateada. Cuando estés satisfecho con el resultado, copia el Swift formateado de vuelta a Xcode, un Playground Swift o tu commit de Git.

Especificaciones Técnicas

Motor y Estilo de Formateo

La herramienta refleja las convenciones comunes de SwiftFormat para mantener tu base de código consistente entre archivos y colaboradores.

AspectoComportamientoNotas
LenguajeSwiftFunciona mejor con archivos fuente Swift 5+.
IndentaciónEspacios configurables por nivelControlado por la opción **Tamaño de Indentación** (1–8).
Ajuste de LíneaColumna de ajuste opcionalControlado por **Ajuste / Longitud de Línea** (0–120; `0` = sin ajuste).
Espacios en BlancoNormalizados alrededor de `:` y operadoresMejora la legibilidad y consistencia en revisiones de código.
Salida IdempotenteMisma entrada → misma salidaSeguro ejecutar múltiples veces sin que el formateo se desvíe.

Entrada Soportada y Límites

Se enfoca en archivos fuente Swift del mundo real utilizados en proyectos de plataformas Apple y Swift del lado del servidor.

ParámetroValor / ComportamientoNotas
Extensiones de archivo.swiftArchivos fuente estándar de Swift.
Tipos MIMEtext/x-swiftSe utiliza internamente para la detección en editores y zonas de soltar.
Tamaño máximo de entrada≈ 2 MB de fuenteLos archivos muy grandes se formatean mejor mediante SwiftFormat local en CI.
Extensión de salida.swiftEl contenido formateado se guarda mejor como archivo fuente de Swift.

Validación y Errores

El formateador espera Swift sintácticamente válido. Si la entrada está incompleta o contiene errores de sintaxis graves, puede fallar o devolver un mensaje de error en lugar de la salida formateada.

Alternativas de Línea de Comandos con SwiftFormat

¿Quieres el mismo estilo en Xcode, CI o ganchos pre-commit? Usa SwiftFormat directamente:

macOS (Homebrew)

Instalar SwiftFormat mediante Homebrew

brew install swiftformat

Añade la CLI `swiftformat` a tu sistema.

Formatear un solo archivo Swift

swiftformat MyViewController.swift

Reescribe el archivo en su lugar usando las reglas predeterminadas de SwiftFormat.

Formatear un proyecto completo de Xcode

swiftformat .

Formatea recursivamente todos los archivos `.swift` en el directorio actual.

Configuración a Nivel de Proyecto

Usar una configuración personalizada

swiftformat . --config .swiftformat

Aplica reglas específicas del equipo almacenadas en un archivo de configuración `.swiftformat`.

Integrar con pre-commit de Git

swiftformat . && git commit

Ejecuta SwiftFormat antes de cada commit para mantener tu rama principal limpia.

Usa esta herramienta en línea para limpiezas rápidas puntuales, luego refleja el mismo estilo en tu repositorio usando SwiftFormat y un archivo `.swiftformat` compartido.

Casos de Uso Prácticos para el Formateador Swift

Desarrollo de Aplicaciones iOS y macOS

Mantén el código basado en UIKit, SwiftUI y Combine legible y consistente entre las ramas de características.

  • Estandariza el formato de controladores de vista, modelos de vista y servicios antes de la revisión de código.
  • Limpia código Swift de borrador o prototipo antes de copiarlo a objetivos de producción.
  • Alinea la indentación y el ajuste de líneas en jerarquías complejas de vistas de SwiftUI.
struct ContentView: View {
  var body: some View {
    VStack {
      Text("Hello")
      Button("Tap me") {
        print("Tapped")
      }
    }
  }
}

Swift del Lado del Servidor (Vapor, Hummingbird, etc.)

Haz que los manejadores de API y el código de enrutamiento sean más fáciles de escanear y revisar.

  • Reformatea rutas y declaraciones de middleware para que las cadenas complejas sean fáciles de seguir.
  • Limpia estructuras de codificación/decodificación JSON con listas largas de propiedades.
  • Asegura un ajuste consistente de llamadas largas de SQL o cliente HTTP dentro del código Swift.
app.get("hello") { req async throws -> String in
    "Hello, world!"
}

Enseñanza y Aprendizaje de Swift

Muestra a los estudiantes cómo se ve el Swift idiomático y reduce el "ruido de estilo" en los ejercicios.

  • Normaliza el código Swift antes de compartir ejemplos en diapositivas o documentación.
  • Limpia las entregas de estudiantes para enfocarse en la lógica en lugar del espaciado y la indentación.
  • Demuestra cómo un buen formato mejora la legibilidad sin cambiar el comportamiento.
func fibonacci(_ n: Int) -> Int {
    if n < 2 { return n }
    return fibonacci(n - 1) + fibonacci(n - 2)
}

❓ Frequently Asked Questions

❓¿Qué cambia realmente este Formateador de Swift?

El formateador ajusta **la indentación, espacios y ajuste de líneas** para seguir las convenciones de estilo Swift. No cambia intencionadamente la lógica de tu código, solo cómo está dispuesto.

📏¿Qué debo elegir para Ajuste / Longitud de Línea?

Las opciones comunes varían de **80 a 100 caracteres**, dependiendo de tu equipo y el ancho de pantalla. Usa un valor más pequeño para diseños estrechos (como Xcode en vista dividida) y un valor mayor si tu equipo se siente cómodo con líneas más anchas. Establécelo en `0` si no deseas ajuste basado en longitud de línea.

🧹¿Es esto un reemplazo para SwiftLint?

No. Un formateador se enfoca en **el diseño y estilo** (indentación, ajuste, espaciado), mientras que SwiftLint se enfoca en **reglas de linting y problemas potenciales** (código no usado, nomenclatura, complejidad). Muchos equipos usan ambos juntos.

🔒¿Es seguro pegar código Swift de producción aquí?

Como regla general, evita pegar código altamente sensible (como algoritmos propietarios o secretos) en cualquier herramienta en línea. Para proyectos confidenciales, prefiere ejecutar SwiftFormat localmente o dentro de tu sistema de CI con una configuración privada.

⚡¿Puedo ejecutar este formateador automáticamente en cada commit?

Sí – usa **SwiftFormat** en tu repositorio (por ejemplo, mediante un hook pre-commit de Git, Fase de Compilación de Xcode o trabajo de CI) para aplicar el mismo estilo automáticamente. Esta herramienta en línea es ideal para comprobaciones rápidas y fragmentos pequeños.

Pro Tips

Best Practice

Acuerda un único **Tamaño de Sangría** y **Longitud de Línea/Ajuste** con tu equipo, luego refleja esos valores tanto en esta herramienta como en tu configuración de `.swiftformat`.

Best Practice

Ejecuta el formateador en las solicitudes de extracción para mantener las revisiones de código centradas en la lógica y la arquitectura en lugar de debates sobre espaciado.

Best Practice

Usa el formateador en código Swift generado (por ejemplo, de herramientas de generación de código) para que luzca tan limpio como tu código escrito a mano.

Best Practice

Combina este formateador con la función "Re-sangrar" de Xcode solo para ajustes locales rápidos; usa SwiftFormat en CI para mantener un estilo verdaderamente consistente.

Additional Resources

SwiftFormat (GitHub)
Documentation
Guías de Diseño de API de Swift.org
Reference
Guía del Lenguaje Swift
Documentation

Other Tools