Código Limpo em Swift: princípios e exemplos para iOS/macOS

Clean Code em Swift: princípios e exemplos na prática

Código Limpo (Clean Code) não é apenas um termo da moda, mas uma habilidade fundamental para todo desenvolvedor que trabalha com Swift para iOS e macOS. No mundo do ecossistema Apple, onde os projetos frequentemente duram anos e são mantidos por diferentes equipes, a capacidade de escrever código compreensível, previsível e facilmente modificável impacta diretamente a velocidade de desenvolvimento e a quantidade de bugs. Neste artigo, vamos analisar os princípios-chave do Clean Code em Swift com exemplos concretos que você pode aplicar em seus projetos hoje mesmo.

Por que o Clean Code é importante para o desenvolvedor Swift?

Swift é uma linguagem poderosa e expressiva, mas sua flexibilidade pode levar ao caos se a disciplina não for seguida. O Código Limpo resolve três problemas principais:

• Legibilidade: Outro desenvolvedor (ou você mesmo daqui a um mês) deve entender o código sem esforço.
• Facilidade de manutenção: Adicionar novos recursos não deve quebrar a lógica antiga.
• Testabilidade: O Código Limpo é facilmente coberto por testes unitários.

Vamos passar da teoria à prática e examinar os princípios principais.

Princípio 1: Nomenclatura — a base da clareza

Um bom nome de variável, função ou classe fala por si só. Em Swift, com sua tipagem forte, isso é especialmente importante. Evite abreviações e nomes de uma letra (exceto em loops).

Ruim:

func calc(a: Int, b: Int) -> Int {    return a * b}

Bom:

func calculateArea(width: Int, height: Int) -> Int {    return width * height}

Regra para Swift: Use CamelCase para variáveis e funções. Os nomes devem responder às perguntas "O que é isso?" ou "O que faz?".

• Variável: userName, maxRetryCount
• Função: fetchData(), validateEmail()
• Classe/Estrutura: UserProfile, NetworkService

Princípio 2: Funções pequenas (Responsabilidade Única)

Cada função deve fazer apenas uma coisa. Se uma função tiver mais de 10-15 linhas ou tiver comentários explicando blocos de código — isso é um sinal para refatoração. Em Swift, isso é especialmente relevante devido ao uso de closures e abordagem funcional.

Exemplo de violação (um método grande):

func processUserData(user: User) {    // Validação    guard user.email.contains("@") else { return }    // Salvar no BD    Database.shared.save(user)    // Enviar notificação    NotificationCenter.default.post(name: .userSaved, object: nil)}

Código Limpo (separação de responsabilidades):

func processUserData(user: User) {    guard validateUser(user) else { return }    saveUser(user)    notifyUserSaved()}

private func validateUser(_ user: User) -> Bool {    return user.email.contains("@")}

private func saveUser(_ user: User) {    Database.shared.save(user)}

private func notifyUserSaved() {    NotificationCenter.default.post(name: .userSaved, object: nil)}

Agora cada função é fácil de testar, modificar e reutilizar.

Princípio 3: Evite números e strings mágicos

Valores codificados ("números mágicos") são inimigos da legibilidade. Em Swift, use constantes e enumerações (enum).

Ruim:

if user.age > 18 {    grantAccess()}

Bom:

private let minimumAgeForAccess = 18

if user.age > minimumAgeForAccess {    grantAccess()}

Para casos mais complexos, use enum:

enum HTTPStatusCode: Int {    case ok = 200    case notFound = 404    case internalError = 500}

func handleResponse(code: Int) {    sw