Swift Academy · Урок

Основы SwiftFormat и SwiftLint

Настройте SwiftFormat для автоматического форматирования кода, а SwiftLint — для выявления проблем со стилем. Запускайте их локально и в CI с помощью простых правил, понятных начинающим.

Урок 1 из 38 шагов

«Основы SwiftFormat и SwiftLint» — бесплатный урок Swift Academy на CoddyKit. Это урок 1 из 3. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Swift Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Swift Academy содержит 3 уроков всего.

Зачем нужны форматирование и проверка стиля?

Цель: поддерживать единообразие и читаемость кода.

  • SwiftFormat → автоматически форматирует исходный код
  • SwiftLint → отмечает проблемы стиля
  • Запускайте инструменты локально и в CI для стабильного качества

SwiftFormat: начало работы

SwiftFormat переписывает файлы в едином стиле. Храните файл .swiftformat в репозитории и запускайте форматирование перед фиксацией изменений.

// 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: основы

SwiftLint анализирует файлы и сообщает о нарушениях. Настраивайте правила в .swiftlint.yml; ограничения должны быть удобными для начинающих.

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

От нарушения к чистому коду

Форматирование исправляет пробелы и переносы строк, а правила проверки стиля помогают улучшить имена и способы использования. Делайте примеры небольшими, чтобы начинающие видели разницу.

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

Рабочий процесс автоматизации

Автоматизируйте оба инструмента: запускайте их локально перед фиксацией изменений, а в CI используйте --strict, чтобы блокировать регрессии.

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

Хорошие начальные правила

Настройки, удобные для начинающих:

  • line_length: 100
  • identifier_name.min_length: 3
  • разрешите простые завершающие запятые
  • на первых этапах отключите несколько слишком шумных правил, а позже включите их

Форматтер и средство проверки стиля

Быстрая проверка: какой инструмент автоматически форматирует код?

Итоги

Итоги: используйте SwiftFormat для создания чистого единообразного исходного кода, а SwiftLint — для применения правил стиля. Делайте конфигурации простыми, запускайте инструменты локально и блокируйте ошибки в CI с помощью --strict.

Можно начать бесплатно

Изучай Swift с ИИ-репетитором — бесплатно

Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.

Курсы
122
Уроки
409

Часто задаваемые вопросы

Урок «Основы SwiftFormat и SwiftLint» бесплатный?

Да — полный текст урока «Основы SwiftFormat и SwiftLint» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Swift Academy, подпишись на CoddyKit PRO. Курс Swift Academy содержит 3 уроков всего.

Чему я научусь в уроке «Основы SwiftFormat и SwiftLint»?

Настройте SwiftFormat для автоматического форматирования кода, а SwiftLint — для выявления проблем со стилем. Запускайте их локально и в CI с помощью простых правил, понятных начинающим. Ты практикуешь Swift Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Swift Academy?

Предыдущий опыт не требуется. Swift Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 3.

Сколько времени занимает урок «Основы SwiftFormat и SwiftLint»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Swift Academy?

Да. Каждый урок Swift Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Основы SwiftFormat и SwiftLint
  2. Руководство по стилю и рекомендации по проектированию API
  3. Документирование кода (введение в DocC)
← Назад к Swift Academy