Как заменить #pragma mark в Swift для организации кода?

Используйте // MARK: – прямой аналог #pragma mark

В Swift нет директивы препроцессора #pragma mark, но разработчики из Apple добавили специальные комментарии, которые распознаются Xcode и работают точно так же. Это // MARK:, // TODO: и // FIXME:. Они не влияют на компиляцию, но создают разделы в панели навигации (Jump Bar) в верхней части редактора.

Основные конструкции:

• // MARK: - текст – создает раздел с горизонтальной линией-разделителем и заголовком.
• // MARK: текст – создает раздел без линии.
• // TODO: текст – добавляет заметку о том, что нужно сделать.
• // FIXME: текст – отмечает проблемный код, который нужно исправить.

Пример для вашего случая:

import UIKit

class MyViewController: UIViewController {

    // MARK: - Lifecycle

    override func viewDidLoad() {
        super.viewDidLoad()
        setupUI()
    }

    override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)
        // Дополнительная логика
    }

    // MARK: - UITableViewDataSource

    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return items.count
    }

    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
        cell.textLabel?.text = items[indexPath.row]
        return cell
    }

    // MARK: - Private Methods

    private func setupUI() {
        // Настройка интерфейса
    }

    // TODO: - Добавить обработку ошибок

    // FIXME: - Исправить потенциальный баг с памятью
}

После добавления этих комментариев откройте панель навигации (View → Navigators → Show Jump Bar или нажмите Ctrl+6). Вы увидите все разделы: "Lifecycle", "UITableViewDataSource", "Private Methods", а также "TODO" и "FIXME" как отдельные пункты. Клик по любому из них мгновенно переместит вас к соответствующему блоку кода.

Советы по использованию:

• Всегда добавляйте дефис (-) после двоеточия, если хотите получить визуальный разделитель. Без дефиса метка появится, но линия не отобразится.
• Группируйте методы по протоколам, жизненному циклу, приватным вспомогательным функциям – это стандарт для Swift-проектов.
• Используйте // TODO: для незавершенных задач – Xcode подсветит их в панели навигации оранжевым цветом.
• Используйте // FIXME: для известных багов – они будут выделены красным.

Этот подход полностью заменяет #pragma mark и даже удобнее, так как не требует препроцессорных директив. Все комментарии игнорируются компилятором, поэтому никаких ошибок не возникнет.

class MyViewController: UIViewController {
    // Основные свойства и lifecycle
}

// MARK: - UITableViewDataSource
extension MyViewController: UITableViewDataSource {
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int { ... }
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell { ... }
}

// MARK: - UITableViewDelegate
extension MyViewController: UITableViewDelegate {
    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) { ... }
}