Repolode
nicklockwood

nicklockwood/SwiftFormat

Swift 코드를 일관된 스타일로 자동 정리하는 CLI 도구이자 Xcode 확장 프로그램입니다.

스타
8,955
포크
727
열린 이슈
289
마지막 커밋
어제

어떤 프로젝트인가요?

SwiftFormat은 macOS, Linux, Windows에서 Swift 코드를 정리하는 코드 라이브러리이자 CLI 도구입니다. 공백 조정뿐 아니라 암시적 self를 추가하거나 제거하고, 불필요한 괄호를 없애며, 표준 Swift 관용구에서 벗어난 여러 부분을 바로잡을 수 있습니다.

팀에서 공통 코딩 스타일을 적용하는 데 드는 비용을 줄이기 위해 수동 검토 대신 규칙을 자동으로 적용합니다. 서식 지정 방식은 150개가 넘는 규칙과 여러 옵션으로 제어할 수 있으며, 명령줄이나 .swiftformat 설정 파일, 소스 주석의 swiftformat 지시문으로 설정할 수 있습니다. lint 모드는 파일을 수정하지 않고 위반 사항을 보고하므로 CI 검사에 적합합니다.

터미널, Swift Package Manager 플러그인, Xcode 빌드 단계 또는 Source Editor Extension으로 실행할 수 있으며, Homebrew, Mint, Nix, Docker 또는 GitHub Actions를 통해 설치할 수 있습니다.

핵심 기능

  • 01암시적 self를 추가하거나 제거하고 불필요한 괄호를 없깁니다.
  • 02개별적으로 활성화하거나 비활성화할 수 있는 150개 이상의 서식 규칙을 제공합니다.
  • 03디렉터리별 재정의를 지원하는 .swiftformat 설정 파일에서 프로젝트 설정을 읽습니다.
  • 04파일을 변경하지 않고 위반 사항을 보고하는 lint 모드를 제공합니다.
  • 05Xcode, Swift Package Manager, Git pre-commit hook 및 GitHub Actions와 연동합니다.

활용 사례

  • 팀의 여러 저장소에 공통 Swift 코딩 스타일을 적용합니다.
  • CI에서 서식 검사를 실행해 형식이 맞지 않는 pull request를 차단합니다.
  • 저장하거나 커밋할 때 Swift 파일을 자동으로 정리합니다.
  • 빌드 중 Xcode 프로젝트의 Swift 코드에 서식을 적용합니다.

빠른 시작

  1. 1

    Homebrew로 명령줄 도구 설치하기

    brew install swiftformat
  2. 2

    현재 디렉터리에 있는 Swift 파일 포맷하기

    swiftformat .

사용 전 알아둘 점

  • swiftformat .을 실행하면 Swift 파일이 제자리에서 덮어쓰기되므로, 먼저 변경 사항을 버전 관리에 커밋하세요.

포함된 컬렉션

토픽

자주 묻는 질문

SwiftFormat은(는) 무엇인가요?
Swift 코드를 일관된 스타일로 자동 정리하는 CLI 도구이자 Xcode 확장 프로그램입니다. SwiftFormat은 macOS, Linux, Windows에서 Swift 코드를 정리하는 코드 라이브러리이자 CLI 도구입니다. 공백 조정뿐 아니라 암시적 self를 추가하거나 제거하고, 불필요한 괄호를 없애며, 표준 Swift 관용구에서 벗어난 여러 부분을 바로잡을 수 있습니다.
SwiftFormat은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
SwiftFormat은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
SwiftFormat은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. SwiftFormat의 마지막 커밋은 2026년 11월 5일입니다.
SwiftFormat은(는) 어디에 사용할 수 있나요?
팀의 여러 저장소에 공통 Swift 코딩 스타일을 적용합니다. CI에서 서식 검사를 실행해 형식이 맞지 않는 pull request를 차단합니다. 저장하거나 커밋할 때 Swift 파일을 자동으로 정리합니다. 빌드 중 Xcode 프로젝트의 Swift 코드에 서식을 적용합니다.
SwiftFormat는 어떻게 설치하나요?
Homebrew로 명령줄 도구 설치하기: brew install swiftformat 현재 디렉터리에 있는 Swift 파일 포맷하기: swiftformat .
SwiftFormat은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nicklockwood/SwiftFormat

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트