SwiftFormat / SwiftLint 기초
코드를 자동 서식 지정하도록 SwiftFormat 을 설정하고, 스타일 문제를 표시하도록 SwiftLint 를 설정합니다. 초보자에게 친숙한 간단한 규칙으로 로컬 환경과 CI에서 실행합니다.
SwiftFormat / SwiftLint 기초은(는) CoddyKit의 무료 Swift Academy 강의입니다. 이것은 3개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Swift Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Swift Academy 강의에는 총 3개의 강의가 포함되어 있습니다.
포맷 및 린트가 필요한 이유
목표: 코드를 일관되고 읽기 쉽게 유지하는 것입니다.
- SwiftFormat → 소스 코드 자동 서식 지정
- SwiftLint → 스타일 문제 표시
- 꾸준한 품질을 위해 로컬과 CI에서 실행
SwiftFormat 시작하기
SwiftFormat은 파일을 균일한 스타일로 다시 작성합니다. 저장소에 .swiftformat을 두고 커밋 전에 실행하십시오.
// 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 기초
SwiftLint은 파일을 분석하고 위반 사항을 보고합니다. .swiftlint.yml에서 규칙을 구성하고, 초보자에게 적합한 제한을 유지하십시오.
// 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")위반 사항에서 깔끔한 코드로
서식 지정은 공백과 줄바꿈을 수정하고, 린트 규칙은 이름과 사용 방식을 개선하도록 유도합니다. 초보자가 차이를 확인할 수 있도록 예시는 작게 유지하십시오.
// BEFORE (bad spacing, short name, unused let)
//let x=1
//print( "Hi" )
//
// AFTER (formatted & lint-friendly):
let count = 1
print("Hi")
print("count =", count)자동화 작업 흐름
두 도구를 모두 자동화하십시오. 커밋 전에 로컬에서 실행하고, CI에서는 --strict를 사용해 회귀를 차단하십시오.
// 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")좋은 시작 규칙
초보자에게 적합한 기본값:
- line_length: 100
- identifier_name.min_length: 3
- 간단한 후행 쉼표 허용
- 초기에는 시끄러운 규칙 몇 가지 비활성화(나중에 활성화)
포매터와 린터 비교
간단 확인: 어떤 도구가 코드를 자동으로 서식 지정하나요?
요약
요약: 깔끔하고 일관된 소스 코드를 작성하려면 SwiftFormat을 사용하고, 스타일 규칙을 적용하려면 SwiftLint를 사용하십시오. 구성은 단순하게 유지하고 로컬에서 실행하며, CI에서는 --strict로 검사를 통과해야 진행되도록 하십시오.
자주 묻는 질문
“SwiftFormat / SwiftLint 기초” 강의는 무료인가요?
네 — “SwiftFormat / SwiftLint 기초” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Swift Academy 강의 전체를 잠금 해제할 수 있습니다. Swift Academy 강의에는 총 3개의 강의가 포함되어 있습니다.
“SwiftFormat / SwiftLint 기초”에서 뭘 배우나요?
코드를 자동 서식 지정하도록 SwiftFormat 을 설정하고, 스타일 문제를 표시하도록 SwiftLint 를 설정합니다. 초보자에게 친숙한 간단한 규칙으로 로컬 환경과 CI에서 실행합니다. 브라우저에서 직접 실행하는 실습 코드로 Swift Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Swift Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Swift Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 3개 중 1번째 강의입니다.
“SwiftFormat / SwiftLint 기초” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Swift Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Swift Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- SwiftFormat / SwiftLint 기초
- 스타일 가이드와 API 설계 지침
- 코드 문서화(DocC 입문)