Repolode
Enviar
nicklockwood

nicklockwood/SwiftFormat

Herramienta de línea de comandos y extensión de Xcode que reformatea automáticamente el código Swift con un estilo coherente.

Ver en GitHub
Estrellas
8,954
Forks
729
Issues abiertos
289
Último commit
hace 5 horas

¿Qué es?

SwiftFormat es una biblioteca de código y una herramienta de línea de comandos para reformatear código Swift en macOS, Linux o Windows. Además de ajustar los espacios en blanco, puede insertar o eliminar self implícito, quitar paréntesis redundantes y corregir muchas otras desviaciones de las convenciones habituales de Swift.

Resuelve el costo de imponer un estilo de código compartido en un equipo aplicando reglas automáticamente en lugar de depender de revisiones manuales. El formato se controla mediante más de 150 reglas y un conjunto de opciones, que se pueden configurar desde la línea de comandos, en un archivo de configuración .swiftformat o en línea mediante directivas swiftformat en los comentarios del código fuente. El modo lint informa de las infracciones sin modificar archivos, por lo que resulta adecuado para comprobaciones de CI.

Se puede ejecutar desde la terminal, como plugin de Swift Package Manager, como fase de compilación de Xcode o mediante una Source Editor Extension. Se puede instalar con Homebrew, Mint, Nix, Docker o GitHub Actions.

Funciones clave

  • 01Inserta o elimina self implícito y quita paréntesis redundantes.
  • 02Ofrece más de 150 reglas de formato que se pueden activar o desactivar individualmente.
  • 03Lee la configuración del proyecto desde un archivo .swiftformat, con opciones específicas por directorio.
  • 04Incluye un modo lint que informa de las infracciones sin modificar archivos.
  • 05Se integra con Xcode, Swift Package Manager, hooks de pre-commit de Git y GitHub Actions.

Casos de uso

  • Imponer un estilo de código Swift compartido en los repositorios de un equipo.
  • Ejecutar comprobaciones de formato en CI para bloquear pull requests sin formato.
  • Formatear archivos Swift automáticamente al guardar o al hacer un commit.
  • Aplicar formato al código Swift de un proyecto de Xcode durante las compilaciones.

Inicio rápido

  1. 1

    Instala la herramienta de línea de comandos con Homebrew

    brew install swiftformat
  2. 2

    Da formato a los archivos Swift del directorio actual

    swiftformat .

Antes de usarlo

  • Al ejecutar swiftformat ., se sobrescriben los archivos Swift directamente. Por eso, confirma primero tus cambios en el control de versiones.

En colecciones

Linters y formateadores de código

Temas

#swift#code-formatter#linter#xcode#command-line#ci#developer-tools

Preguntas frecuentes

¿Qué es SwiftFormat?
Herramienta de línea de comandos y extensión de Xcode que reformatea automáticamente el código Swift con un estilo coherente. SwiftFormat es una biblioteca de código y una herramienta de línea de comandos para reformatear código Swift en macOS, Linux o Windows. Además de ajustar los espacios en blanco, puede insertar o eliminar self implícito, quitar paréntesis redundantes y corregir muchas otras desviaciones de las convenciones habituales de Swift.
¿SwiftFormat es gratuito? ¿Qué licencia tiene?
SwiftFormat es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿SwiftFormat sigue mantenido?
Mantenimiento activo. El último commit de SwiftFormat fue el 7 nov 2026.
¿Para qué puedo usar SwiftFormat?
Imponer un estilo de código Swift compartido en los repositorios de un equipo. Ejecutar comprobaciones de formato en CI para bloquear pull requests sin formato. Formatear archivos Swift automáticamente al guardar o al hacer un commit. Aplicar formato al código Swift de un proyecto de Xcode durante las compilaciones.
¿Cómo se instala SwiftFormat?
Instala la herramienta de línea de comandos con Homebrew: brew install swiftformat Da formato a los archivos Swift del directorio actual: swiftformat .
¿Dónde consigo SwiftFormat?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/nicklockwood/SwiftFormat

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados