#pragma mark en Swift 2025 : Les secrets d'organisation du code que l'on ne vous dit pas

Introduction : Pourquoi votre code crie à l'aide (et comment MARK: l'apaise)

Imaginez : vous ouvrez un fichier Swift de 500 lignes. Vos yeux parcourent l'écran, vous cherchez la méthode tableView(_:cellForRowAt:), mais vous vous noyez dans un océan de func et de var. Cela vous parle ? En 2025, alors que les projets deviennent de plus en plus complexes et que la vitesse de développement est cruciale, une telle situation est une voie directe vers les bugs et la perte de temps.

Sur Stack Overflow, la question "#pragma mark in Swift?" a recueilli des milliers de vues. Et pour cause. Les développeurs venant d'Objective-C cherchaient un outil familier, et les débutants un moyen de mettre de l'ordre dans leur code. La réponse est simple et élégante : Swift n'a pas de #pragma mark, mais il possède un équivalent plus puissant — // MARK:.

Dans cet article, nous ne nous contenterons pas de vous expliquer comment utiliser // MARK: en Swift. Nous vous montrerons les meilleures pratiques de 2025 qui transformeront votre code en une œuvre d'art, compréhensible par vous dans un an comme par vos collègues. Préparez Xcode — ça va être intéressant.

Qu'est-ce que // MARK: en Swift et pourquoi en avez-vous besoin ?

Si vous avez déjà travaillé avec Objective-C, vous vous souvenez de #pragma mark. C'est une directive de préprocesseur qui aidait à regrouper les méthodes dans le panneau de navigation de Xcode. Swift l'a abandonnée, mais a conservé la fonctionnalité via des commentaires spéciaux.

// MARK: est un commentaire que Xcode interprète comme un séparateur de sections. Il ajoute dans le panneau de navigation (Jump Bar) un titre en gras et une ligne de séparation. Voici à quoi cela ressemble :

// MARK: - Lifecycle\n\noverride func viewDidLoad() {\n    super.viewDidLoad()\n}\n\n// MARK: - Table View Data Source\n\nfunc tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {\n    return items.count\n}\n

Notez le tiret après MARK: (// MARK: -). Il ajoute une ligne horizontale de séparation. Sans le tiret, vous aurez simplement un texte en gras. Utilisez les deux variantes selon le degré de séparation visuelle souhaité entre les blocs.

Mots-clés pour le référencement : utilisation de // MARK: en Swift, organisation du code Swift, navigation Xcode.

Meilleures pratiques d'utilisation de // MARK: en 2025

Insérer // MARK: partout est une mauvaise idée. Cela créerait du bruit. Voici des techniques éprouvées utilisées par les meilleurs développeurs iOS.

1. Regroupez par protocoles et responsabilités

Le scénario le plus courant est l'implémentation de plusieurs protocoles dans une même classe. Ne forcez pas vos collègues à deviner où se termine UITableViewDelegate et où commence UITableViewDataSource.

final class ProfileViewController: UIViewController {\n\n    // MARK: - Properties\n\n    private let viewModel: ProfileViewModel\n    private let tableView = UITableView()\n\n    // MARK: - Lifecycle\n\n    override func viewDidLoad() {\n        super.viewDidLoad()\n        setupUI()\n    }\n\n    // MARK: - UITableViewDataSource\n\n    override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {\n        return viewModel.sections.count\n    }\n\n    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {\n        // ...\n    }\n\n    // MARK: - UITableViewDelegate\n\n    func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {\n        viewModel.didSelectRow(at: indexPath)\n    }\n\n    // MARK: - Private Methods\n\n    private func setupUI() {\n        // ...\n    }\n}\n

C'est la référence absolue. Chaque bloc est responsable d'une unité logique.

2. Utilisez // MARK: - pour les sections logiques au sein d'une classe

Même si vous n'implémentez pas de protocoles, divisez les longues classes en sections : Public Methods, Private Methods, Helpers, Acti