JSON을 Swift Codable struct 코드로 변환하세요!

JSON을 입력하면 중첩 객체까지 Swift Codable struct 코드(CodingKeys)로 변환합니다! iOS JSONDecoder용.
JSON
결과
 

JSON을 Swift Codable struct 코드로 변환하세요!

JSON을 Codable을 채택한 Swift struct로 변환합니다. 프로퍼티는 let으로 선언되고 이름은 camelCase로 바뀌며, JSON 키와 이름이 달라지는 struct에만 CodingKeys enum을 만들어 줍니다.

iOS·macOS 앱에서 URLSession으로 받은 응답을 JSONDecoder로 디코딩할 모델이 필요할 때, SwiftUI 미리보기용 목업 JSON에 맞는 타입을 빠르게 만들고 싶을 때 유용합니다.

사용 방법

  1. Proxyman·Charles 등으로 캡처한 API 응답 본문을 붙여넣습니다.
  2. 타입 이름에 최상위 struct 이름을 적습니다(예: EpisodePage).
  3. 결과를 Swift 파일에 붙여넣습니다. import Foundation이 포함되어 있습니다.
  4. try JSONDecoder().decode(EpisodePage.self, from: data)로 디코딩합니다.

예시

입력 (JSON)
{
  "podcast": "Swift Talk",
  "episodes": [
    { "id": 301, "title": "Async Sequences", "duration": 1840, "explicit": false },
    { "id": 302, "title": "Macros", "duration": 2215.5, "explicit": false, "guest_name": "Chris" }
  ],
  "total_count": 2
}
출력 (Swift · Codable)
import Foundation

struct EpisodePage: Codable {
    let podcast: String
    let episodes: [Episode]
    let totalCount: Int

    enum CodingKeys: String, CodingKey {
        case podcast
        case episodes
        case totalCount = "total_count"
    }
}

struct Episode: Codable {
    let id: Int
    let title: String
    let duration: Double
    let explicit: Bool
    let guestName: String?

    enum CodingKeys: String, CodingKey {
        case id
        case title
        case duration
        case explicit
        case guestName = "guest_name"
    }
}

episodes 배열 요소는 Episode struct가 되었습니다. duration은 정수(1840)와 소수(2215.5)가 섞여 Double, 두 번째 에피소드에만 있는 guest_name은 guestName: String?입니다. 이름이 바뀐 필드가 있는 struct에는 모든 키를 나열한 CodingKeys가 생깁니다.

지원 기능

  • struct마다 Codable 채택, 프로퍼티는 불변 let.
  • snake_case·kebab-case 키는 camelCase 프로퍼티로 바꾸고, 그런 경우에만 enum CodingKeys: String, CodingKey로 원래 키를 지정합니다.
  • 타입: String, Int, Double, Bool, 배열은 [T].
  • 일부 항목에만 있거나 null이 섞인 필드는 Optional(String?)이 되어 키가 없어도 디코딩됩니다.
  • 타입이 섞인 값은 디코딩 가능한 JSONValue enum을 함께 만들어 그 타입으로 둡니다.
  • default, class, self 같은 Swift 키워드 키는 백틱으로 감쌉니다.
  • 최상위가 배열이면 typealias Root = [RootItem]을 만듭니다.

사용 사례

URLSession + async/await 네트워킹

let (data, _) = try await URLSession.shared.data(from: url) 다음 줄에 바로 JSONDecoder().decode를 쓸 수 있는 모델을 응답 예시 하나로 만들 수 있습니다.

SwiftUI 리스트 화면

생성된 struct에 Identifiable만 추가하면(id 필드가 있는 경우) List(page.episodes) { ... }에 바로 넘길 수 있습니다.

번들에 넣은 목업 데이터

디자인 단계에서 받은 샘플 JSON을 앱 번들에 넣고 같은 모델로 디코딩하면, 실제 API가 준비되기 전에도 화면을 만들 수 있습니다.

주의사항

  • 날짜 문자열은 String으로 나옵니다. Date로 받으려면 프로퍼티 타입을 바꾸고 decoder.dateDecodingStrategy = .iso8601 같은 전략을 설정하세요.
  • Optional이 아닌 프로퍼티의 키가 응답에 없으면 DecodingError.keyNotFound가 납니다. 예시에 항상 있던 필드라도 API에서 빠질 수 있다면 ?를 붙이세요.
  • 모든 프로퍼티가 let이라 값을 바꿔야 하는 화면 상태용 모델이라면 var로 바꿔야 합니다.
  • Identifiable, Hashable 같은 추가 프로토콜은 채택하지 않습니다.
  • JSONValue enum은 섞인 타입을 처리하기 위한 보조 코드라, 이미 프로젝트에 비슷한 타입이 있다면 지우고 그 타입을 쓰면 됩니다.

자주 묻는 질문

keyDecodingStrategy = .convertFromSnakeCase를 쓰면 CodingKeys를 지워도 되나요?

네, 그렇게 하면 guest_name ↔ guestName 변환을 디코더가 해 줍니다. 단, 두 방식을 같이 쓰면 디코더가 키를 먼저 camelCase로 바꾼 뒤 CodingKeys의 "guest_name"과 비교해서 매칭에 실패하니 하나만 쓰세요.

왜 class가 아니라 struct인가요?

응답 모델은 값 타입으로 다루는 것이 Swift의 일반적인 관례이고, struct는 멤버와이즈 이니셜라이저가 자동으로 생겨 테스트 데이터를 만들기도 쉽습니다. 참조 의미가 필요하면 final class로 바꾸고 이니셜라이저를 추가하세요.

정수인데 Double로 나온 필드가 있어요.

같은 키에 정수와 소수가 섞여 있으면 정보 손실이 없도록 Double이 됩니다. 반대로 예시의 값이 모두 4.0처럼 소수점 아래가 0이면 브라우저 JSON 파서가 정수로 읽어 Int가 될 수 있으니, 실제 API 값을 확인하세요.

Encodable로 다시 JSON을 만들면 원래 키가 유지되나요?

CodingKeys가 인코딩에도 쓰이므로 JSONEncoder로 다시 직렬화하면 guest_name처럼 원래 키로 나옵니다. Optional 값이 nil이면 해당 키는 생략됩니다.