디버깅하기 좋은 형식 만들기
설명과 리플렉션을 효과적으로 결합합니다.
디버깅하기 좋은 형식 만들기은(는) CoddyKit의 무료 Swift Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Swift Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
도구 결합하기
좋은 형식은 검사하기 쉽습니다. CustomStringConvertible, CustomDebugStringConvertible, Mirror를 결합하면 값을 명확하게 출력하고 필요할 때 내부 구조를 확인할 수 있습니다.
깔끔한 description
사용자에게 보여 줄 출력을 먼저 작성합니다:
struct Vector: CustomStringConvertible {
let x: Double
let y: Double
var description: String { "(\(x), \(y))" }
}
print(Vector(x: 1, y: 2)) // (1.0, 2.0)진단용 debugDescription 추가
디버깅을 위한 세부 정보를 덧붙입니다:
struct Vector: CustomStringConvertible, CustomDebugStringConvertible {
let x: Double
let y: Double
var description: String { "(\(x), \(y))" }
var debugDescription: String { "Vector(x: \(x), y: \(y), len: \(length))" }
var length: Double { (x * x + y * y).squareRoot() }
}
debugPrint(Vector(x: 3, y: 4)) // Vector(x: 3.0, y: 4.0, len: 5.0)Mirror로 description 자동 생성
모든 필드를 직접 나열하지 않고 리플렉션을 사용해 description을 만듭니다:
struct Auto: CustomStringConvertible {
let a = 1
let b = "x"
var description: String {
let fields = Mirror(reflecting: self).children
.map { "\($0.label ?? "_")=\($0.value)" }
.joined(separator: ", ")
return "Auto(\(fields))"
}
}
print(Auto()) // Auto(a=1, b=x)재사용 가능한 리플렉션 도우미
Mirror 로직을 전역 함수로 분리하면 여러 형식이 하나의 디버그 형식 지정기를 공유할 수 있습니다.
공유 describe 도우미
하나의 도우미를 어디서나 재사용합니다:
func reflectiveDescription(_ value: Any) -> String {
let name = String(describing: type(of: value))
let parts = Mirror(reflecting: value).children
.map { "\($0.label ?? "_"): \($0.value)" }
.joined(separator: ", ")
return "\(name)(\(parts))"
}
struct P { let id = 7; let tag = "z" }
print(reflectiveDescription(P())) // P(id: 7, tag: z)프로토콜 기본 구현
프로토콜 확장을 통해 형식 전체에 리플렉션을 활용한 디버깅 기능을 제공합니다:
protocol Inspectable: CustomStringConvertible {}
extension Inspectable {
var description: String {
let parts = Mirror(reflecting: self).children
.map { "\($0.label ?? "_")=\($0.value)" }
.joined(separator: ", ")
return "\(type(of: self))[\(parts)]"
}
}
struct Widget: Inspectable { let w = 10; let h = 20 }
print(Widget()) // Widget[w=10, h=20]중첩된 값 예쁘게 출력하기
자식 자체가 출력 가능한 값이면 리플렉션은 자연스럽게 재귀적으로 동작합니다:
struct Inner: CustomStringConvertible { let v = 1; var description: String { "Inner(\(v))" } }
struct Outer: CustomStringConvertible {
let inner = Inner()
var description: String { "Outer(\(inner))" }
}
print(Outer()) // Outer(Inner(1))스위프트 덤프 사용
내장된 dump는 Mirror를 사용해 깊이 있고 들여쓰기된 트리를 출력하므로 빠르게 검사할 때 편리합니다:
struct Node { let id = 1; let kids = [2, 3] }
dump(Node())
// - id: 1
// - kids: 2 elements ...모두 결합하기
완성도 높은 형식은 깔끔한 description, 풍부한 디버그 정보, 리플렉션 기반 대체 수단을 갖추므로 로그를 기록하고 디버깅하기 쉽습니다.
struct Order: CustomStringConvertible, CustomDebugStringConvertible {
let id: Int
let total: Double
var description: String { "Order #\(id)" }
var debugDescription: String { "Order(id: \(id), total: \(total))" }
}
let o = Order(id: 5, total: 9.99)
print(o) // Order #5
debugPrint(o) // Order(id: 5, total: 9.99)리플렉션으로 필드 세기
리플렉션은 속성 개수 세기와 같은 구조에 대한 간단한 검사를 수행할 때도 유용합니다:
struct Profile { let name = "A"; let age = 1; let city = "X" }
let fieldCount = Mirror(reflecting: Profile()).children.count
print("Profile has \(fieldCount) fields") // Profile has 3 fields빠른 확인
모든 속성을 직접 나열하지 않고 어떻게 description을 만들 수 있습니까?
복습
디버깅하기 쉬운 형식을 만드는 방법을 배웠습니다:
description(깔끔한 정보)과debugDescription(상세한 정보)을 결합합니다Mirror를 사용해 자식으로부터 description을 자동 생성합니다- 리플렉션을 도우미 또는 프로토콜 기본 구현으로 분리합니다
dump는 빠른 검사를 위해 깊이 있는 리플렉션 트리를 출력합니다
과정을 완료했습니다!
자주 묻는 질문
“디버깅하기 좋은 형식 만들기” 강의는 무료인가요?
네 — “디버깅하기 좋은 형식 만들기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Swift Academy 강의 전체를 잠금 해제할 수 있습니다. Swift Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“디버깅하기 좋은 형식 만들기”에서 뭘 배우나요?
설명과 리플렉션을 효과적으로 결합합니다. 브라우저에서 직접 실행하는 실습 코드로 Swift Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Swift Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Swift Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“디버깅하기 좋은 형식 만들기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Swift Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Swift Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.