Loading…

Informazioni Formattatore Swift Online

Scrivere Swift che **compila** è facile. Scrivere Swift che sia **bello, coerente e pronto per la revisione** è più difficile. Questo formattatore Swift online utilizza regole in stile SwiftFormat per normalizzare l'indentazione, la spaziatura e l'avvolgimento delle righe, in modo che i tuoi file `.swift` rimangano puliti su Xcode, Swift Playgrounds e pipeline CI.

Caratteristiche Principali del Formattatore Swift

  • **Pulizia con un clic** di indentazione, spaziatura e parentesi nel codice Swift
  • **Dimensione indentazione configurabile** tramite il cursore *Dimensione Indentazione* (1–8 spazi)
  • **Controllo Avvolgimento / Lunghezza Righe** per mantenere le espressioni lunghe entro la larghezza di colonna preferita
  • Supporta file sorgente `.swift` standard e snippet incollati
  • Ottimo per progetti **iOS, macOS, watchOS, tvOS e Swift server-side**
  • Utilizza un motore in stile SwiftFormat dietro le quinte per un output Swift idiomatico
  • Formattazione idempotente – eseguirlo più volte mantiene lo stesso output
  • Nessun account richiesto – basta incollare, formattare e copiare il risultato pulito

🛠️ Come Utilizzare il Formattatore Swift for swift-formatter

1

1. Incolla o Carica il Tuo Codice Swift

📥 Incolla direttamente il codice Swift nell'editor, oppure trascina e rilascia un file `.swift`. Lo strumento è ottimizzato per sorgenti Swift tipiche in stile Xcode.

2

2. Imposta Indentazione e Lunghezza Righe

📏 Usa il cursore **Dimensione Indentazione** per scegliere quanti spazi usare per ogni livello di indentazione, e configura **A capo / Lunghezza Riga** per controllare dove le righe lunghe dovrebbero andare a capo (o impostalo su `0` per disabilitare la formattazione basata su a capo).

3

3. Clicca "Formatta"

⚡ Premi il pulsante **Formatta** per applicare le regole in stile SwiftFormat. Il formattatore normalizza l'indentazione, gli spazi attorno a `:` e agli operatori, e va a capo nelle righe lunghe secondo le tue impostazioni.

4

4. Rivedi e Copia il Risultato

🔍 Confronta le versioni originale e formattata. Quando sei soddisfatto del risultato, copia il Swift formattato di nuovo in Xcode, in un Swift Playground, o nel tuo commit Git.

Specifiche Tecniche

Motore di Formattazione & Stile

Lo strumento rispecchia le convenzioni comuni di SwiftFormat per mantenere la tua codebase coerente tra file e contributori.

AspettoComportamentoNote
LinguaggioSwiftFunziona meglio con file sorgente Swift 5+.
IndentazioneSpazi configurabili per livelloControllato dall'opzione **Dimensione Indentazione** (1–8).
A capo rigaColonna di a capo opzionaleControllato da **A capo / Lunghezza Riga** (0–120; `0` = nessun a capo).
Spazi bianchiNormalizzati attorno a `:` e operatoriMigliora la leggibilità e la coerenza nelle revisioni del codice.
Output IdempotenteStesso input → stesso outputSicuro da eseguire più volte senza deriva della formattazione.

Input Supportato & Limiti

Si concentra su file sorgente Swift del mondo reale utilizzati in progetti Swift per piattaforme Apple e lato server.

ParametroValore / ComportamentoNote
Estensioni file.swiftFile sorgente Swift standard.
Tipi MIMEtext/x-swiftUtilizzato internamente per il rilevamento nell'editor e nella zona di rilascio.
Dimensione massima input≈ 2 MB di sorgenteI file molto grandi sono meglio formattati tramite SwiftFormat locale in CI.
Estensione output.swiftIl contenuto formattato è meglio salvato come file sorgente Swift.

Validazione & Errori

Il formattatore si aspetta Swift sintatticamente valido. Se l'input è incompleto o contiene errori di sintassi gravi, potrebbe fallire o restituire un messaggio di errore invece dell'output formattato.

Alternative da Rig di Comando con SwiftFormat

Vuoi lo stesso stile in Xcode, CI o hook pre-commit? Usa SwiftFormat direttamente:

macOS (Homebrew)

Installa SwiftFormat tramite Homebrew

brew install swiftformat

Aggiunge la CLI `swiftformat` al tuo sistema.

Formatta un singolo file Swift

swiftformat MyViewController.swift

Riscrive il file sul posto utilizzando le regole predefinite di SwiftFormat.

Formatta un intero progetto Xcode

swiftformat .

Formatta ricorsivamente tutti i file `.swift` nella directory corrente.

Configurazione a Livello Progetto

Usa una configurazione personalizzata

swiftformat . --config .swiftformat

Applica regole specifiche del team memorizzate in un file di configurazione `.swiftformat`.

Integra con Git pre-commit

swiftformat . && git commit

Esegui SwiftFormat prima di ogni commit per mantenere pulito il tuo ramo principale.

Usa questo strumento online per pulizie rapide occasionali, poi rispecchia lo stesso stile nel tuo repository utilizzando SwiftFormat e un file `.swiftformat` condiviso.

Casi d'Uso Pratici per il Formattatore Swift

Sviluppo App iOS & macOS

Mantieni il codice UIKit, SwiftUI e Combine leggibile e coerente tra i rami delle funzionalità.

  • Standardizza la formattazione di view controller, view model e servizi prima della revisione del codice.
  • Pulisci il codice Swift di prova o prototipo prima di copiarlo nei target di produzione.
  • Allinea l'indentazione e l'avvolgimento delle gerarchie di viste SwiftUI complesse.
struct ContentView: View {
  var body: some View {
    VStack {
      Text("Hello")
      Button("Tap me") {
        print("Tapped")
      }
    }
  }
}

Swift Lato Server (Vapor, Hummingbird, ecc.)

Rendi i gestori API e il codice di routing più facili da scansionare e revisionare.

  • Riformatta le route e le dichiarazioni middleware in modo che le catene complesse siano facili da seguire.
  • Pulisci le struct di codifica/decodifica JSON con elenchi di proprietà lunghi.
  • Assicura un avvolgimento coerente delle chiamate SQL o HTTP client lunghe all'interno del codice Swift.
app.get("hello") { req async throws -> String in
    "Hello, world!"
}

Insegnamento & Apprendimento Swift

Mostra agli studenti come appare lo Swift idiomatico e riduci il "rumore di stile" negli esercizi.

  • Normalizza il codice Swift prima di condividere esempi in slide o documentazione.
  • Pulisci i compiti degli studenti per concentrarsi sulla logica invece che su spaziatura e indentazione.
  • Dimostra come una buona formattazione migliori la leggibilità senza cambiare il comportamento.
func fibonacci(_ n: Int) -> Int {
    if n < 2 { return n }
    return fibonacci(n - 1) + fibonacci(n - 2)
}

❓ Frequently Asked Questions

❓Cosa cambia effettivamente questo Swift Formatter?

Il formatter regola **indentazione, spazi e avvolgimento righe** per seguire le convenzioni di stile Swift. Non cambia intenzionalmente la logica del tuo codice – solo come è disposto.

📏Cosa dovrei scegliere per Avvolgimento / Lunghezza Riga?

Le scelte comuni vanno da **80 a 100 caratteri**, a seconda del tuo team e della larghezza del display. Usa un valore più piccolo per layout stretti (come Xcode in vista divisa) e un valore più grande se il tuo team è a suo agio con righe più ampie. Impostalo a `0` se non vuoi l'avvolgimento basato sulla lunghezza riga.

🧹È un sostituto di SwiftLint?

No. Un formatter si concentra su **layout e stile** (indentazione, avvolgimento, spaziatura), mentre SwiftLint si concentra su **regole di linting e potenziali problemi** (codice inutilizzato, denominazione, complessità). Molti team usano entrambi insieme.

🔒È sicuro incollare codice Swift di produzione qui?

Come regola generale, evita di incollare codice altamente sensibile (come algoritmi proprietari o segreti) in qualsiasi strumento online. Per progetti confidenziali, preferisci eseguire SwiftFormat localmente o all'interno del tuo sistema CI con una configurazione privata.

⚡Posso eseguire questo formatter automaticamente ad ogni commit?

Sì – usa **SwiftFormat** nel tuo repository (ad esempio tramite un hook Git pre-commit, Fase di Build Xcode o job CI) per applicare automaticamente lo stesso stile. Questo strumento online è ideale per controlli rapidi e piccoli snippet.

Pro Tips

Best Practice

Concorda con il tuo team una singola **Dimensione del Rientro** e **Lunghezza della Righe / A capo**, quindi rifletti quei valori sia in questo strumento che nella tua configurazione `.swiftformat`.

Best Practice

Esegui il formattatore sulle richieste di pull per mantenere le revisioni del codice concentrate sulla logica e l'architettura invece che su dibattiti sugli spazi.

Best Practice

Usa il formattatore sul codice Swift generato (ad esempio da strumenti di codegen) in modo che appaia pulito come il tuo codice scritto a mano.

Best Practice

Combina questo formattatore con il "Ri-indenta" di Xcode solo per modifiche locali rapide; usa SwiftFormat in CI per mantenere uno stile veramente coerente.

Additional Resources

SwiftFormat (GitHub)
Documentation
Linee Guida Progettazione API Swift.org
Reference
Guida al Linguaggio Swift
Documentation

Other Tools