Loading…

Sobre Formatador Swift Online

Escrever Swift que **compila** é fácil. Escrever Swift que é **bonito, consistente e pronto para revisão** é mais difícil. Este Formatador Swift online usa regras no estilo SwiftFormat para normalizar indentação, espaçamento e quebra de linha, para que seus arquivos `.swift` permaneçam limpos no Xcode, Swift Playgrounds e pipelines de CI.

Principais Características do Formatador Swift

  • **Limpeza com um clique** de indentação, espaçamento e chaves em código Swift
  • **Tamanho de indentação configurável** através do controle deslizante *Tamanho da Indentação* (1–8 espaços)
  • **Controle de Quebra / Comprimento de Linha** para manter expressões longas dentro da largura de coluna preferida
  • Suporta arquivos de origem `.swift` padrão e trechos colados
  • Ótimo para projetos **iOS, macOS, watchOS, tvOS e Swift server-side**
  • Utiliza um motor estilo SwiftFormat nos bastidores para uma saída idiomática em Swift
  • Formatação idempotente – executar várias vezes mantém a mesma saída
  • Nenhuma conta necessária – basta colar, formatar e copiar o resultado limpo

🛠️ Como Usar o Formatador Swift for swift-formatter

1

1. Cole ou Carregue Seu Código Swift

📥 Cole o código Swift diretamente no editor, ou arraste e solte um arquivo `.swift`. A ferramenta é otimizada para fontes Swift típicas do estilo Xcode.

2

2. Defina Indentação e Comprimento da Linha

📏 Use o controle deslizante **Tamanho da Indentação** para escolher quantos espaços cada nível de indentação deve usar, e configure **Quebra / Comprimento da Linha** para controlar onde as linhas longas devem ser quebradas (ou defina como `0` para desativar a formatação baseada em quebra).

3

3. Clique em “Formatar”

⚡ Pressione o botão **Formatar** para aplicar as regras estilo SwiftFormat. O formatador normaliza a indentação, espaços ao redor de `:` e operadores, e quebra linhas longas de acordo com suas configurações.

4

4. Revise e Copie o Resultado

🔍 Compare as versões original e formatada. Quando estiver satisfeito com o resultado, copie o Swift formatado de volta para o Xcode, um Playground Swift ou seu commit no Git.

Especificações Técnicas

Motor e Estilo de Formatação

A ferramenta espelha as convenções comuns do SwiftFormat para manter sua base de código consistente entre arquivos e colaboradores.

AspectoComportamentoNotas
LinguagemSwiftFunciona melhor com arquivos fonte Swift 5+.
IndentaçãoEspaços configuráveis por nívelControlado pela opção **Tamanho da Indentação** (1–8).
Quebra de LinhaColuna de quebra opcionalControlado por **Quebra / Comprimento da Linha** (0–120; `0` = sem quebra).
Espaços em BrancoNormalizado ao redor de `:` e operadoresMelhora a legibilidade e consistência nas revisões de código.
Saída IdempotenteMesma entrada → mesma saídaSeguro para executar várias vezes sem alterar a formatação.

Entrada Suportada e Limites

Foca em arquivos fonte Swift do mundo real usados em projetos de plataforma Apple e Swift do lado do servidor.

ParâmetroValor / ComportamentoNotas
Extensões de arquivo.swiftArquivos fonte padrão do Swift.
Tipos MIMEtext/x-swiftUsado internamente para detecção no editor e zona de soltar.
Tamanho máximo de entrada≈ 2 MB de fonteArquivos muito grandes são melhor formatados via SwiftFormat local no CI.
Extensão de saída.swiftO conteúdo formatado é melhor salvo como um arquivo fonte Swift.

Validação e Erros

O formatador espera Swift sintaticamente válido. Se a entrada estiver incompleta ou contiver erros de sintaxe graves, pode falhar ou retornar uma mensagem de erro em vez da saída formatada.

Alternativas de Linha de Comando com SwiftFormat

Quer o mesmo estilo no Xcode, CI ou hooks de pré-commit? Use o SwiftFormat diretamente:

macOS (Homebrew)

Instalar SwiftFormat via Homebrew

brew install swiftformat

Adiciona a CLI `swiftformat` ao seu sistema.

Formatar um único arquivo Swift

swiftformat MyViewController.swift

Reescreve o arquivo no local usando as regras padrão do SwiftFormat.

Formatar um projeto Xcode inteiro

swiftformat .

Formata recursivamente todos os arquivos `.swift` no diretório atual.

Configuração no Nível do Projeto

Usar uma configuração personalizada

swiftformat . --config .swiftformat

Aplica regras específicas da equipe armazenadas em um arquivo de configuração `.swiftformat`.

Integrar com pré-commit do Git

swiftformat . && git commit

Execute o SwiftFormat antes de cada commit para manter seu branch principal limpo.

Use esta ferramenta online para limpezas rápidas e únicas, depois espelhe o mesmo estilo em seu repositório usando SwiftFormat e um arquivo `.swiftformat` compartilhado.

Casos de Uso Práticos para o Formatador Swift

Desenvolvimento de Aplicativos iOS e macOS

Mantenha o código pesado em UIKit, SwiftUI e Combine legível e consistente entre branches de funcionalidades.

  • Padronize a formatação de controladores de visualização, modelos de visualização e serviços antes da revisão de código.
  • Limpe códigos Swift de rascunho ou protótipo antes de copiá-los para destinos de produção.
  • Alinhe a indentação e quebra de linhas de hierarquias complexas de visualização SwiftUI.
struct ContentView: View {
  var body: some View {
    VStack {
      Text("Olá")
      Button("Toque-me") {
        print("Tocado")
      }
    }
  }
}

Swift no Servidor (Vapor, Hummingbird, etc.)

Torne os manipuladores de API e código de roteamento mais fáceis de escanear e revisar.

  • Reformate rotas e declarações de middleware para que cadeias complexas sejam fáceis de seguir.
  • Limpe structs de codificação/decodificação JSON com longas listas de propriedades.
  • Garanta o envolvimento consistente de chamadas longas de SQL ou cliente HTTP dentro do código Swift.
app.get("olá") { req async throws -> String in
    "Olá, mundo!"
}

Ensinando e Aprendendo Swift

Mostre aos alunos como é o Swift idiomático e reduza o "ruído de estilo" nos exercícios.

  • Normalize o código Swift antes de compartilhar exemplos em slides ou documentação.
  • Limpe as submissões dos alunos para focar na lógica em vez de espaçamento e indentação.
  • Demonstre como uma boa formatação melhora a legibilidade sem alterar o comportamento.
func fibonacci(_ n: Int) -> Int {
    if n < 2 { return n }
    return fibonacci(n - 1) + fibonacci(n - 2)
}

❓ Frequently Asked Questions

❓O que este Formatador Swift realmente altera?

O formatador ajusta **indentação, espaços e quebra de linhas** para seguir as convenções de estilo Swift. Ele não altera intencionalmente a lógica do seu código – apenas como ele é disposto.

📏O que devo escolher para Envolvimento / Comprimento de Linha?

Escolhas comuns variam de **80 a 100 caracteres**, dependendo da sua equipe e largura de exibição. Use um valor menor para layouts estreitos (como Xcode em visualização dividida) e um valor maior se sua equipe estiver confortável com linhas mais largas. Defina como `0` se não quiser envolvimento baseado no comprimento da linha.

🧹Isso é um substituto para o SwiftLint?

Não. Um formatador foca em **layout e estilo** (indentação, envolvimento, espaçamento), enquanto o SwiftLint foca em **regras de linting e problemas potenciais** (código não utilizado, nomenclatura, complexidade). Muitas equipes usam ambos juntos.

🔒É seguro colar código Swift de produção aqui?

Como regra geral, evite colar códigos altamente sensíveis (como algoritmos proprietários ou segredos) em qualquer ferramenta online. Para projetos confidenciais, prefira executar o SwiftFormat localmente ou dentro do seu sistema de CI com uma configuração privada.

⚡Posso executar este formatador automaticamente em cada commit?

Sim – use o **SwiftFormat** no seu repositório (por exemplo, via um hook pré-commit do Git, Fase de Build do Xcode ou job de CI) para impor o mesmo estilo automaticamente. Esta ferramenta online é ideal para verificações rápidas e pequenos trechos.

Pro Tips

Best Practice

Combine com sua equipe um único **Tamanho de Indentação** e **Quebra / Comprimento de Linha**, depois reflita esses valores tanto nesta ferramenta quanto na sua configuração `.swiftformat`.

Best Practice

Execute o formatador em pull requests para manter as revisões de código focadas na lógica e arquitetura em vez de debates sobre espaçamento.

Best Practice

Use o formatador em código Swift gerado (por exemplo, de ferramentas de geração de código) para que pareça tão limpo quanto seu código escrito à mão.

Best Practice

Combine este formatador com o “Re-Indentar” do Xcode apenas para ajustes locais rápidos; use o SwiftFormat no CI para manter um estilo verdadeiramente consistente.

Additional Resources

SwiftFormat (GitHub)
Documentation
Diretrizes de Design de API do Swift.org
Documentation
Guia da Linguagem Swift
Documentation

Other Tools