JSON 转 Swift

相关推荐

关于 JSON 转 Swift：把 JSON 数据变成 Apple 生态原生类型

适用场景

• iOS 开发：把后端 REST API 返回的 JSON 转成 Swift struct，用于 SwiftUI 或 UIKit 网络层建模与 JSONDecoder 解码
• macOS 开发：把应用配置 JSON 转成 Swift 类型，在 AppKit 项目中做类型安全的配置读取，避免拼写错误
• watchOS 开发：为 Apple Watch 应用把健康、运动数据 JSON 转成 Swift 模型并接入 SwiftUI 与 HealthKit
• tvOS 开发：把内容推荐接口 JSON 转成 Swift 类型，用于电视应用首页数据展示与焦点导航
• SwiftUI MVVM 建模：把 API 数据模型直接作为 @Published 属性绑定到 ViewModel，再驱动界面视图
• Combine 响应式数据流：将 JSON 响应类型作为 Publisher 的输出类型，配合 JSONDecoder 做响应式解析
• SwiftData / Core Data 前置建模：先生成 Swift struct，再手动添加 @Model 或 @NSManaged 注解进行实体映射
• 第三方 SDK 对接：把 SDK 文档中的 JSON 响应示例转成 Swift 类型，快速接入登录、支付、推送、地图等 SDK
• 单元测试准备：把接口 mock JSON 转成 Swift 类型后用于 XCTest 测试数据与断言，提升测试可维护性
• 代码评审：把 API 返回 JSON 转成 Swift 类型，便于团队 Code Review 时讨论字段命名与可选性
• Flutter / React Native 混合开发：为调用原生 Swift 模块准备数据模型，减少 bridge 层的类型转换错误
• 后端接口迁移：从 REST 接口文档或 Postman 示例 JSON 生成 Swift 客户端模型，跨版本升级时快速同步
• 教学培训：Swift / iOS 课程中演示 JSON 到类型系统的映射，帮助学生理解 API 数据建模与类型安全
• 健康与健身应用：把 HealthKit / Fitbit 等接口返回的 JSON 转成 Swift 类型，用于 Apple Health 数据建模
• 支付与金融应用：把支付网关的接口响应 JSON 转成 Swift 模型，便于对账和异常处理
• 电商订单系统：把订单、商品、地址等 JSON 转成 Swift struct，配合 SwiftUI 列表与详情页展示
• 新闻与内容应用：把内容管理系统的 JSON 响应转成 Swift 类型，用于 TableView / SwiftUI 列表 / 详情页
• Vapor 服务端开发：把后端 API 的请求/响应 JSON 转成 Swift 结构体，用于服务端模型定义与 Codable 编解码
• MapKit 与地理数据：把地图接口返回的 JSON 转成 Swift struct，用于地点检索、路线规划、地理编码结果建模

使用方法

1. 在左侧编辑器粘贴 JSON 内容，或点击上传按钮选择 .json / .txt 文件，也可加载内置示例数据
2. 工具会在 400ms 防抖后自动调用 quicktype-core 转换，右侧显示生成的 Swift struct / class 代码
3. 如果 JSON 格式错误，点击「修复 JSON」按钮自动修复常见语法问题（尾随逗号、单引号、缺引号等）
4. 检查生成结果，可根据项目需要手动添加 Codable / Equatable / Identifiable 等协议；点击「复制」粘贴到 Xcode，或点击「下载」保存为 .swift 文件

功能特点

• 纯浏览器本地转换：JSON 解析与 Swift 代码生成全部在浏览器内通过 quicktype-core 完成，原始 JSON 和生成代码均不上传任何服务器
• quicktype-core just-types 模式：输出为干净的 Swift struct / class 属性声明，无 import、无 Codable / CodingKeys 等注释，方便按项目需要再加工
• 400ms 防抖自动转换：粘贴或修改 JSON 后几乎实时生成 Swift 类型，无需反复点击转换按钮，转换过程完全异步不阻塞 UI
• Web Worker 后台执行：quicktype-core 在浏览器 Web Worker 中运行，避免大 JSON 转换时冻结主线程与编辑卡顿
• 智能类型推断：自动映射 String、Int、Double、Bool、[T]、自定义类型，数组按首项类型推断，不需要手写字段类型
• 嵌套对象自动展开：递归为每个嵌套对象生成独立的 Swift 类型，按字段名首字母大写命名，避免类型重复定义
• 数组类型自动推断：JSON 数组自动转换为 [String] / [Int] / [Double] / [自定义类型]，空数组默认生成 [Any]
• 一键 JSON 错误修复：遇到尾随逗号、单引号、缺引号、注释等常见格式错误时，可一键自动修复并继续转换
• 一键复制 + .swift 下载：把生成的 Swift 代码一键复制到剪贴板，或下载为 .swift 文件直接拖入 Xcode 项目
• 示例数据 + 文件上传：内置 Swift 风格的示例 JSON（含嵌套 address / company / tags），支持拖拽或点击上传 .json / .txt 文件
• localStorage 输入历史：自动保存最近输入，刷新或误关页面后可快速恢复继续编辑，不用担心内容丢失
• 响应式分屏编辑器：左右分屏实时预览，桌面与移动端自适应，小屏也能顺畅操作

代码示例

import Foundation

// 1) 本工具生成的根类型（补上 Codable 协议）
struct User: Codable {
    let id: Int
    let name: String
    let email: String
    let isActive: Bool
    let tags: [String]
}

// 2) URLSession 异步获取并解码
func fetchUser(id: Int) async throws -> User {
    let url = URL(string: "https://api.example.com/users/\(id)")!
    let (data, response) = try await URLSession.shared.data(from: url)
    guard
        let http = response as? HTTPURLResponse,
        (200..<300).contains(http.statusCode)
    else {
        throw URLError(.badServerResponse)
    }
    return try JSONDecoder().decode(User.self, from: data)
}

// 3) 使用示例（Swift 5.5+ async/await）
Task {
    do {
        let user = try await fetchUser(id: 42)
        print("User: \(user.name), tags: \(user.tags)")
    } catch {
        print("Failed to decode:", error)
    }
}

import Foundation
import Alamofire

// 本工具生成的类型，添加 Codable 后直接可用
struct Product: Codable {
    let id: Int
    let title: String
    let price: Double
    let inStock: Bool
    let images: [String]
}

final class ProductService {
    private let session: Session

    init(session: Session = .default) {
        self.session = session
    }

    /// Alamofire 5 async/await 风格的 responseDecodable
    func loadProduct(id: Int) async throws -> Product {
        let url = "https://api.example.com/products/\(id)"
        return try await withCheckedThrowingContinuation { continuation in
            session.request(url)
                .validate(statusCode: 200..<300)
                .responseDecodable(of: Product.self) { response in
                    switch response.result {
                    case .success(let product):
                        continuation.resume(returning: product)
                    case .failure(let error):
                        continuation.resume(throwing: error)
                    }
                }
        }
    }
}

// Moya 风格调用示例
// provider.request(.product(id: 1)).map(Product.self)
// let product: Product = try await provider.request(.product(id: 1)).map(Product.self)

import Foundation
import Combine

// 本工具生成的根类型
struct Article: Codable, Identifiable {
    let id: Int
    let title: String
    let body: String
    let publishedAt: Date
}

final class ArticleRepository {
    private let session: URLSession
    private var cancellables = Set<AnyCancellable>()

    init(session: URLSession = .shared) {
        self.session = session
    }

    /// 用 Combine 暴露数据流
    func articlePublisher(id: Int) -> AnyPublisher<Article, Error> {
        let url = URL(string: "https://api.example.com/articles/\(id)")!
        let decoder = JSONDecoder()
        decoder.dateDecodingStrategy = .iso8601

        return session.dataTaskPublisher(for: url)
            .map(\.data)
            .decode(type: Article.self, decoder: decoder)
            .receive(on: DispatchQueue.main)
            .eraseToAnyPublisher()
    }

    /// 在 SwiftUI ViewModel 中订阅
    func bind(to viewModel: ArticleViewModel, articleId: Int) {
        articlePublisher(id: articleId)
            .sink(
                receiveCompletion: { completion in
                    if case .failure(let err) = completion {
                        viewModel.errorMessage = err.localizedDescription
                    }
                },
                receiveValue: { article in
                    viewModel.article = article
                }
            )
            .store(in: &cancellables)
    }
}

final class ArticleViewModel: ObservableObject {
    @Published var article: Article?
    @Published var errorMessage: String?
}

最佳实践

常见问题

故障排查

术语表

struct

Swift 中的值类型。默认适合表示不可变数据模型，赋值时会被复制。本工具默认生成 struct 用于表示 JSON 对象。

class

Swift 中的引用类型。适合需要共享状态、继承或身份标识（===）的场景。本工具在某些配置下可生成 class。

Optional（?）

Swift 中表示值可能为 nil 的类型修饰符，如 var name: String?。本工具生成的字段默认非 Optional，生成后可根据 JSON 字段是否可缺失手动添加 ?。

Array（[T]）

Swift 中的数组类型简写。本工具把 JSON 数组转换为 [T]，T 按数组元素类型推断，如 [String]、[Int] 或 [自定义类型]。

Codable

Swift 中 Decodable 与 Encodable 的协议组合。实现 Codable 后可用 JSONDecoder 把 JSON 数据解析为类型实例。本工具默认不生成 Codable，需手动添加。

JSONDecoder

Foundation 框架中的 JSON 解析器。配合 Codable 协议使用，可把 Data 转换为 Swift 类型实例。本工具输出纯类型后，开发者可自行用 JSONDecoder 解析。

URLSession

Apple 平台 Foundation 框架中的网络请求 API。常见用法是 URLSession.shared.data(from: url)，与 JSONDecoder 配合完成接口联调。

Alamofire

Swift 社区最流行的第三方 HTTP 网络库。基于 URLSession 封装，支持 responseDecodable 直接反序列化为 Swift 类型。

Moya

Swift 网络抽象层，通常与 Alamofire 搭配。Moya 配合 Codable 类型可大幅简化 API 调用样板代码。

Vapor

Swift 主流的服务端框架，使用 Swift 在 macOS / Linux 上构建 Web 应用。本工具生成的 Swift 结构体同样可以用于 Vapor 的路由模型。

quicktype

支持多语言的类型生成器开源工具，本工具通过 quicktype-core 在浏览器 Web Worker 中完成 JSON 到 Swift 的转换。

Property

Swift 类型中的属性声明。本工具把 JSON 的每个 key 映射为一个 Swift property，例如 "name": "Alice" 映射为 var name: String。

Type Inference

根据 JSON 值的字面量形式自动推断 Swift 类型的过程。本工具依据 null、boolean、number、string、array、object 做映射。

localStorage

浏览器本地键值存储。本工具用 localStorage 保存最近输入历史，刷新或误关页面后可恢复。

Web Worker

浏览器提供的后台线程机制。本工具通过 Web Worker 加载和执行 quicktype-core，避免大 JSON 转换阻塞主线程。

SwiftUI

Apple 推出的声明式 UI 框架。本工具生成的 Swift 类型可作为 SwiftUI 视图的数据模型，配合 @State / @ObservedObject 驱动界面。

Combine

Apple 的响应式编程框架。生成的 Swift 类型结合 JSONDecoder 可构建 dataTaskPublisher 响应式数据流。

SwiftData

Apple 2023 年推出的数据持久化框架。本工具生成的类型可作为 SwiftData 模型基类，添加 @Model 后即可被 SwiftData 管理。

Value Type / Reference Type

Swift 中 struct 是值类型，class 是引用类型。本工具默认生成 struct，赋值时被复制；如需引用语义可手动改为 class。

Field Naming

本工具默认保留 JSON 原字段名。若源 JSON 为 snake_case 而项目要求 camelCase，需要手动 rename 或自定义 quicktype 渲染器。

ISO 8601 日期

常见 JSON 日期格式，如 2026-07-14T10:00:00Z。需要配套 JSONDecoder.dateDecodingStrategy = .iso8601 才能正确解析到 Date 类型。

JSON 类型到 Swift 类型映射速查表

工具根据 JSON 值的形式自动推断对应的 Swift 类型：

JSON 转 Swift 在 Apple 生态中的常见使用场景

生成的 Swift 类型可以直接用于 Apple 平台 / 第三方框架的不同场景：

Privacy & Security

本 JSON 转 Swift 工具所有 JSON 解析、Swift 类型生成操作完全在你的浏览器本地通过 JavaScript（quicktype-core / Web Worker）完成，输入的 JSON 数据和生成的 Swift 代码都不会被上传到任何服务器，也不会被记录、缓存或存储到云端。包含内部接口字段、API key、token、用户隐私数据、未公开业务结构的敏感 JSON 都可以放心使用，关闭或刷新页面后所有输入和输出内容自动从内存清除，不依赖任何第三方网络服务。

Authoritative References

• AppleApple Developer - Swift Codable 官方文档
• Swift.orgSwift.org - 官方文档
• AppleApple Developer - JSONDecoder 文档
• AlamofireAlamofire GitHub 仓库
• quicktypequicktype GitHub 仓库