0Pricing
Swift Academy · Lekcja

Podstawy SwiftFormat i SwiftLint

Skonfiguruj SwiftFormat do automatycznego formatowania kodu oraz SwiftLint do wykrywania problemów ze stylem. Uruchamiaj je lokalnie i w CI, korzystając z prostych reguł przyjaznych początkującym.

Podstawy SwiftFormat i SwiftLint to bezpłatna lekcja Swift Academy na CoddyKit. To lekcja 1 z 3. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Swift Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Swift Academy zawiera 3 lekcji w sumie.

Po co formatować i używać lintera?

Cel: utrzymywać spójny i czytelny kod.

  • SwiftFormat → automatycznie formatuje kod źródłowy
  • SwiftLint → zgłasza problemy ze stylem
  • Uruchamianie lokalnie i w CI zapewnia stałą jakość

SwiftFormat: pierwsze kroki

SwiftFormat przepisuje pliki do jednolitego stylu. W repozytorium należy przechowywać plik .swiftformat i uruchamiać narzędzie przed zatwierdzeniem zmian.

// 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: podstawy

SwiftLint analizuje pliki i zgłasza naruszenia reguł. Reguły należy konfigurować w pliku .swiftlint.yml, zachowując limity przyjazne początkującym.

// 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")

Od naruszeń do czystego kodu

Formatowanie poprawia odstępy i podziały wierszy, a reguły lintera pomagają korygować nazwy i sposób użycia. Przykłady powinny być krótkie, aby początkujący mogli zobaczyć różnicę.

// BEFORE (bad spacing, short name, unused let)
//let x=1
//print(  "Hi"  )
//
// AFTER (formatted & lint-friendly):
let count = 1
print("Hi")
print("count =", count)

Automatyzacja pracy

Należy zautomatyzować oba narzędzia: uruchamiać je lokalnie przed zatwierdzeniem zmian, a w CI używać --strict, aby blokować regresje.

// 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")

Dobre reguły na początek

Ustawienia domyślne przyjazne początkującym:

  • line_length: 100
  • identifier_name.min_length: 3
  • zezwalać na proste końcowe przecinki
  • na początku wyłączyć kilka uciążliwych reguł (włączyć je później)

Formater a linter

Szybkie sprawdzenie: Które narzędzie automatycznie formatuje kod?

Podsumowanie

Podsumowanie: Należy używać SwiftFormat do tworzenia czystego, spójnego kodu źródłowego, a SwiftLint do egzekwowania reguł stylu. Konfiguracje powinny być proste, narzędzia należy uruchamiać lokalnie, a CI zabezpieczać za pomocą --strict.

Często zadawane pytania

Czy lekcja „Podstawy SwiftFormat i SwiftLint” jest bezpłatna?

Tak — pełny tekst „Podstawy SwiftFormat i SwiftLint” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Swift Academy, przejdź na CoddyKit PRO. Kurs Swift Academy zawiera 3 lekcji w sumie.

Co nauczysz się w „Podstawy SwiftFormat i SwiftLint”?

Skonfiguruj SwiftFormat do automatycznego formatowania kodu oraz SwiftLint do wykrywania problemów ze stylem. Uruchamiaj je lokalnie i w CI, korzystając z prostych reguł przyjaznych początkującym. Ćwiczysz Swift Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Swift Academy?

Nie wymagamy żadnego doświadczenia. Swift Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 3.

Ile czasu zajmuje lekcja „Podstawy SwiftFormat i SwiftLint”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Swift Academy?

Tak. Każda lekcja Swift Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Podstawy SwiftFormat i SwiftLint
  2. Przewodnik stylu i wytyczne projektowania API
  3. Dokumentowanie kodu (wprowadzenie do DocC)
← Powrót do Swift Academy