Noções básicas de SwiftFormat / SwiftLint
Configure o SwiftFormat para formatar o código automaticamente e o SwiftLint para sinalizar problemas de estilo. Execute localmente e na CI com regras simples e acessíveis para iniciantes.
Noções básicas de SwiftFormat / SwiftLint é uma aula grátis de Swift Academy no CoddyKit. Esta é a aula 1 de 3. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Swift Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Swift Academy inclui 3 aulas no total.
Por que formatar e analisar o estilo?
Objetivo: manter o código consistente e legível.
- SwiftFormat → formatar automaticamente o código-fonte
- SwiftLint → sinalizar problemas de estilo
- Executar localmente e na CI para manter a qualidade
SwiftFormat: primeiros passos
SwiftFormat reescreve os arquivos em um estilo uniforme. Mantenha um arquivo .swiftformat no repositório e execute-o antes dos commits.
// Install & run (examples):
// mint install nicklockwood/SwiftFormat // via Mint
// swiftformat . // format repo
// swiftformat Sources --config .swiftformat // use config file
//
// Minimal .swiftformat (put in repo root):
// --ifdef no
// --wrapcollections before-first
// --maxwidth 100
print("SwiftFormat: run to auto-format code consistently")SwiftLint: conceitos básicos
SwiftLint analisa os arquivos e relata violações. Configure as regras em .swiftlint.yml e mantenha limites adequados para iniciantes.
// Install & run (examples):
// brew install swiftlint // macOS example
// swiftlint lint // check whole repo
// swiftlint lint --strict // fail on warnings in CI
//
// Minimal .swiftlint.yml (example):
// disabled_rules:
// - trailing_whitespace
// opt_in_rules:
// - empty_count
// line_length: 100
// identifier_name:
// min_length: 3
print("SwiftLint: report style issues with configurable rules")Da violação ao código limpo
A formatação corrige espaços e quebras de linha; as regras de análise orientam nomes e uso. Mantenha os exemplos pequenos para que iniciantes percebam a diferença.
// BEFORE (bad spacing, short name, unused let)
//let x=1
//print( "Hi" )
//
// AFTER (formatted & lint-friendly):
let count = 1
print("Hi")
print("count =", count)Fluxo de automação
Automatize as duas ferramentas: execute-as localmente antes de fazer o commit; na CI, use --strict para bloquear regressões.
// Simple pre-commit idea (document in README):
// swiftformat . && swiftlint lint --strict
//
// GitHub Actions (sketch) — put in CI config, not here:
// - run: swiftformat --version && swiftformat .
// - run: swiftlint lint --strict
//
// Tip: start lenient (warnings), then turn strict in CI once the repo is clean.
print("Automate: run format+lint locally and in CI")Boas regras para começar
Padrões iniciais adequados para iniciantes:
- line_length: 100
- identifier_name.min_length: 3
- permita vírgulas finais simples
- desative algumas regras muito ruidosas no início (ative-as mais tarde)
Formatador versus analisador de estilo
Verificação rápida: Qual ferramenta formata o código automaticamente?
Recapitulação
Recapitulação: Use SwiftFormat para escrever código-fonte limpo e consistente e SwiftLint para aplicar regras de estilo. Mantenha as configurações simples, execute-as localmente e use --strict para controlar a CI.
Perguntas Frequentes
A aula “Noções básicas de SwiftFormat / SwiftLint” é grátis?
Sim — o texto completo de “Noções básicas de SwiftFormat / SwiftLint” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Swift Academy, atualize para CoddyKit PRO. O curso de Swift Academy inclui 3 aulas no total.
O que vou aprender em “Noções básicas de SwiftFormat / SwiftLint”?
Configure o SwiftFormat para formatar o código automaticamente e o SwiftLint para sinalizar problemas de estilo. Execute localmente e na CI com regras simples e acessíveis para iniciantes. Você pratica Swift Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Swift Academy?
Nenhuma experiência prévia é necessária. Swift Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 3.
Quanto tempo leva a aula “Noções básicas de SwiftFormat / SwiftLint”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Swift Academy?
Sim. Cada aula de Swift Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Noções básicas de SwiftFormat / SwiftLint
- Guia de estilo e diretrizes de design de APIs
- Documentando código (introdução ao DocC)