Repolode
realm

realm/SwiftLint

Linter que aplica padrões e convenções de estilo em Swift, com mais de 200 regras configuráveis por projeto.

Estrelas
19,779
Forks
2,338
Issues abertas
535
Último commit
anteontem

O que é?

O SwiftLint verifica o código-fonte Swift com base em um conjunto de regras de estilo e convenções e informa violações como avisos ou erros no terminal ou diretamente no Xcode. A maioria das regras é baseada no SwiftSyntax, e um conjunto menor usa Clang e SourceKit para acessar informações de tipos. As regras são ativadas ou desativadas por meio de um arquivo .swiftlint.yml, no qual você também pode ajustar limites, como o comprimento das linhas e dos corpos de tipos.

Para arquivos com violações que podem ser corrigidas automaticamente, a opção --fix reescreve o conteúdo no próprio lugar. O comando analyze, separado, executa regras que usam a AST completa com verificação de tipos, embora sejam mais lentas e opt-in. É possível definir regras personalizadas com expressões regulares no arquivo de configuração ou escrevê-las em Swift.

O SwiftLint pode ser instalado pelo Homebrew, CocoaPods, Mint, Bazel ou Swift Package Manager e pode ser executado na CI via Docker, fastlane ou um hook de pre-commit.

Recursos principais

  • 01Mais de 200 regras integradas de estilo e convenções para código Swift
  • 02Integração com o Xcode que mostra as violações diretamente no editor
  • 03Correção automática de violações corrigíveis com --fix
  • 04Comando analyze com reconhecimento de tipos para regras que precisam da AST completa
  • 05Regras personalizadas baseadas em regex e mesclagem de arquivos de configuração pai e filho

Casos de uso

  • Aplicar um guia de estilo Swift compartilhado nos projetos iOS ou macOS de uma equipe
  • Executar verificações de lint em pipelines de CI via Docker, fastlane ou hooks de pre-commit
  • Limpar gradualmente código legado usando baselines e correção automática

Início rápido

  1. 1

    Instale o SwiftLint com o Homebrew

    brew install swiftlint
  2. 2

    Execute o SwiftLint no diretório do seu projeto

    swiftlint

Antes de usar

  • Algumas regras dependem do Clang e do SourceKit para obter informações de tipos, e o SwiftLint foi projetado para analisar apenas código compilável.
  • Usar --fix em código que não compila pode gerar resultados confusos.

Em coleções

Tópicos

Perguntas frequentes

O que é SwiftLint?
Linter que aplica padrões e convenções de estilo em Swift, com mais de 200 regras configuráveis por projeto. O SwiftLint verifica o código-fonte Swift com base em um conjunto de regras de estilo e convenções e informa violações como avisos ou erros no terminal ou diretamente no Xcode. A maioria das regras é baseada no SwiftSyntax, e um conjunto menor usa Clang e SourceKit para acessar informações de tipos. As regras são ativadas ou desativadas por meio de um arquivo .swiftlint.yml, no qual você também pode ajustar limites, como o comprimento das linhas e dos corpos de tipos.
SwiftLint é gratuito? Qual é a licença?
SwiftLint é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
SwiftLint ainda é mantido?
Manutenção ativa. O último commit de SwiftLint foi em 5 de nov. de 2026.
Para que posso usar SwiftLint?
Aplicar um guia de estilo Swift compartilhado nos projetos iOS ou macOS de uma equipe Executar verificações de lint em pipelines de CI via Docker, fastlane ou hooks de pre-commit Limpar gradualmente código legado usando baselines e correção automática
Como instalar SwiftLint?
Instale o SwiftLint com o Homebrew: brew install swiftlint Execute o SwiftLint no diretório do seu projeto: swiftlint
Onde consigo SwiftLint?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/realm/SwiftLint

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados