Ответ
1. Официальные Swift API Design Guidelines от Apple
Это основной стандарт, на который ориентируются все инструменты (например, swift-format).
- Именование: Используйте
camelCaseдля методов и свойств,PascalCaseдля типов и протоколов. - Читаемость: Имена должны быть понятными на английском языке, избегайте неочевидных сокращений (
index, а неidx). - Грамматика: Названия методов должны образовывать грамматически правильные фразы:
x.insert(y, at: z), а неx.insert(y, position: z).
// Пример по гайдлайнам Apple
struct ShoppingCart {
var items: [Item]
func calculateTotalPrice() -> Decimal {
return items.reduce(0) { $0 + $1.price }
}
}
2. Руководство по стилю Ray Wenderlich Популярное среди сообщества, дополняет гайдлайны Apple конкретными правилами форматирования.
- Отступы и пробелы: 4 пробела для отступа. Пробелы вокруг операторов (
a + b). - Переносы: Длинные строки следует переносить, стараясь не превышать лимит в 100 символов.
- Организация кода: Четкий порядок объявлений внутри типа (сначала свойства, затем инициализаторы, потом методы).
Ключевое отличие: Гайдлайны Apple фокусируются на семантике имен и использовании API, а стиль Ray Wenderlich — на форматировании и организации файлов. В проектах часто используют гибридный подход, принимая за основу правила Apple и дополняя их выбранными правилами форматирования.