Conceptos básicos de SwiftFormat / SwiftLint
Configure SwiftFormat para dar formato automático al código y SwiftLint para señalar problemas de estilo. Ejecútelos localmente y en CI con reglas sencillas y adecuadas para principiantes.
Conceptos básicos de SwiftFormat / SwiftLint es una lección gratuita de Swift Academy en CoddyKit. Esta es la lección 1 de 3. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Swift Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Swift Academy incluye 3 lecciones en total.
¿Por qué formatear y usar lint?
Objetivo: Mantener el código coherente y legible.
- SwiftFormat → formatea automáticamente el código fuente
- SwiftLint → señala problemas de estilo
- Ejecute ambas herramientas localmente y en CI para mantener una calidad constante
SwiftFormat: primeros pasos
SwiftFormat reescribe los archivos con un estilo uniforme. Mantenga un archivo .swiftformat en el repositorio y ejecútelo antes de hacer commits.
// Install & run (examples):
// mint install nicklockwood/SwiftFormat // via Mint
// swiftformat . // format repo
// swiftformat Sources --config .swiftformat // use config file
//
// Minimal .swiftformat (put in repo root):
// --ifdef no
// --wrapcollections before-first
// --maxwidth 100
print("SwiftFormat: run to auto-format code consistently")SwiftLint: conceptos básicos
SwiftLint analiza los archivos e informa de las infracciones. Configure las reglas en .swiftlint.yml y mantenga límites adecuados para principiantes.
// Install & run (examples):
// brew install swiftlint // macOS example
// swiftlint lint // check whole repo
// swiftlint lint --strict // fail on warnings in CI
//
// Minimal .swiftlint.yml (example):
// disabled_rules:
// - trailing_whitespace
// opt_in_rules:
// - empty_count
// line_length: 100
// identifier_name:
// min_length: 3
print("SwiftLint: report style issues with configurable rules")De la infracción al código limpio
El formateo corrige los espacios y los saltos de línea; las reglas de lint sugieren mejoras en los nombres y el uso. Mantenga los ejemplos pequeños para que los principiantes vean la diferencia.
// BEFORE (bad spacing, short name, unused let)
//let x=1
//print( "Hi" )
//
// AFTER (formatted & lint-friendly):
let count = 1
print("Hi")
print("count =", count)Flujo de trabajo de automatización
Automatice ambas herramientas: ejecútelas localmente antes de hacer commits; en CI use --strict para impedir regresiones.
// Simple pre-commit idea (document in README):
// swiftformat . && swiftlint lint --strict
//
// GitHub Actions (sketch) — put in CI config, not here:
// - run: swiftformat --version && swiftformat .
// - run: swiftlint lint --strict
//
// Tip: start lenient (warnings), then turn strict in CI once the repo is clean.
print("Automate: run format+lint locally and in CI")Buenas reglas para empezar
Valores predeterminados adecuados para principiantes:
- line_length: 100
- identifier_name.min_length: 3
- permita comas finales sencillas
- desactive al principio algunas reglas demasiado restrictivas (actívelas más adelante)
Formateador frente a linter
Comprobación rápida: ¿Qué herramienta formatea el código automáticamente?
Repaso
Repaso: Use SwiftFormat para escribir código fuente limpio y coherente, y SwiftLint para aplicar las reglas de estilo. Mantenga las configuraciones sencillas, ejecute las herramientas localmente y bloquee las regresiones en CI con --strict.
Preguntas frecuentes
¿La lección «Conceptos básicos de SwiftFormat / SwiftLint» es gratis?
Sí — el texto completo de «Conceptos básicos de SwiftFormat / SwiftLint» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Swift Academy, actualiza a CoddyKit PRO. El curso de Swift Academy incluye 3 lecciones en total.
¿Qué aprenderé en «Conceptos básicos de SwiftFormat / SwiftLint»?
Configure SwiftFormat para dar formato automático al código y SwiftLint para señalar problemas de estilo. Ejecútelos localmente y en CI con reglas sencillas y adecuadas para principiantes. Practicas Swift Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Swift Academy?
No se requiere experiencia previa. Swift Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 3.
¿Cuánto tiempo toma la lección «Conceptos básicos de SwiftFormat / SwiftLint»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Swift Academy?
Sí. Cada lección de Swift Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Conceptos básicos de SwiftFormat / SwiftLint
- Guía de estilo y pautas de diseño de API
- Documentar código (introducción a DocC)