SwiftFormat: O Estilista Automático para Seu Código Swift

Quando o Código Se Formata Sozinho

Imagine: em uma equipe de cinco desenvolvedores, cada um escreve código do seu jeito. Alguns adicionam espaços antes dos colchetes, outros não. Um prefere quebrar parâmetros de funções em várias linhas, outro escreve tudo em uma única linha. O resultado é uma base de código em patchwork, e a revisão de código se transforma em debates intermináveis sobre estilo.

SwiftFormat resolve exatamente esse problema — uma ferramenta para formatação automática de código Swift. Ele não apenas adiciona espaços e indentação, ele traz o código a um padrão unificado, corrigindo centenas de pequenas inconsistências.

O Que o SwiftFormat Pode Fazer?

1. Trabalho profundo de estilo:

   • Corrige indentação e alinhamento
   • Remove self e colchetes redundantes
   • Corrige ordem de modificadores de acesso
   • Unifica estilo de declaração de closures

2. Configuração flexível:

   • Mais de 50 regras de formatação
   • Suporte para arquivos de configuração .swiftformat
   • Capacidade de criar regras personalizadas

3. Integração em qualquer lugar:

   • Linha de comando para execução manual
   • Plugins para Xcode, VSCode, Sublime Text
   • Hooks pre-commit do Git
   • Suporte CI/CD via GitHub Actions

// До форматирования
func processData(data:[String:Any], completion:(Result)->Void){
    guard let value=data["key"] else{return}
    self.completion(.success(value))
}

// После SwiftFormat
func processData(
    data: [String: Any],
    completion: (Result) -> Void
) {
    guard let value = data["key"] else { return }
    completion(.success(value))
}

Como Começar a Usar?

Instalação via Homebrew:

brew install swiftformat

Uso básico:

# Форматировать все файлы в текущей директории
swiftformat .

# Только проверить стиль без изменений (линтер)
swiftformat --lint .

Para projetos, é recomendado adicionar SwiftFormat como uma etapa de build no Xcode ou um hook pre-commit no Git. Dessa forma, o código será automaticamente formatado antes de cada commit.

Flexibilidade de Configuração

SwiftFormat entende que cada projeto tem seus próprios requisitos de estilo. Você pode:

• Desabilitar regras individuais via --disable
• Criar um arquivo .swiftformat na raiz do projeto
• Configurar comportamento para arquivos específicos via comentários

Exemplo de configuração:

# .swiftformat
--indent 4
--disable trailingCommas
--enable isEmpty
--header "Copyright (c) {year} MyCompany"

Por Que Experimentar?

1. Economia de tempo — não gaste mais horas em formatação manual
2. Estilo consistente — sem mais debates em equipe sobre onde colocar colchetes
3. Histórico git limpo — menos commits de "estilo"
4. Foco na lógica — concentre-se no que realmente importa

SwiftFormat é especialmente útil para:

• Equipes de 2+ desenvolvedores
• Projetos com histórico longo de desenvolvimento
• Revisões de código frequentes
• Manter qualidade de projetos open source

Por Trás das Cortinas

O projeto está em desenvolvimento ativo desde 2016, tem mais de 8,5k estrelas no GitHub e suporta todas as versões atuais do Swift. Por trás das cortinas está um poderoso parser de código Swift e um sistema de regras que você pode combinar como blocos de LEGO.

# Показать все доступные правила
swiftformat --rules

# Информация о конкретном правиле
swiftformat --rule-info redundantSelf

Alternativas

• SwiftLint: Mais focado em encontrar problemas de código do que formatação
• Scripts personalizados: Requerem manutenção e são frequentemente menos flexíveis

A principal vantagem do SwiftFormat é que ele não apenas encontra problemas — ele os corrige imediatamente.

SwiftFormat não é apenas "outra ferramenta" — é um verdadeiro salvador para equipes cansadas de correções intermináveis de estilo. Ele cuida de todo o trabalho rotineiro de formatação, permitindo que você se concentre em resolver problemas reais.

Experimente adicioná-lo ao seu fluxo de trabalho — você verá resultados após a primeira execução. Seu código ficará mais limpo, e a vida — mais fácil.