🔄 JSON转Swift结构体

JSON转Swift结构体工具能做什么？

JSON转Swift结构体工具是一款免费在线开发者工具，能够将JSON数据一键转换为Swift语言的struct定义代码。自动识别JSON字段类型并映射为Swift类型，支持嵌套对象生成独立结构体、Codable协议遵循、CodingKeys枚举映射、可选类型处理等功能。适用于iOS/macOS开发者快速从API响应生成模型定义，大幅减少手动编写struct的工作量。所有转换在浏览器本地完成，数据绝不上传服务器。

核心功能

• 智能类型映射：自动将string→String、number→Int/Double、boolean→Bool、array→[T]、null→可选类型
• 嵌套结构体：JSON中的嵌套对象自动生成为独立的struct定义
• Codable协议：生成的struct默认遵循Codable，可直接用于JSONEncoder/JSONDecoder
• CodingKeys：当Swift属性名与JSON键名不同时，自动生成CodingKeys枚举
• 可选类型：null值字段生成为可选类型（String?），确保Swift类型安全

使用教程

1. 在JSON输入框中粘贴您的JSON数据，或点击"加载示例"快速体验。

2. 设置结构体名称和转换选项：Codable、可选类型、CodingKeys等。

3. 点击"转换"按钮，或使用快捷键Ctrl+Enter执行转换。

4. 在下方结果区域查看生成的Swift结构体代码。

5. 点击"复制代码"将结果复制到剪贴板，或下载为.swift文件。

应用场景

场景1：iOS应用开发

iOS开发者对接REST API时，将JSON响应粘贴到工具中，一键生成带Codable的结构体，配合JSONDecoder直接解码。

场景2：Swift后端

Vapor或Perfect后端开发者，从请求体JSON示例快速生成模型结构体，加速API开发。

场景3：SwiftUI数据模型

在SwiftUI项目中，从JSON数据快速生成ObservableObject或Model结构体定义。

场景4：跨平台项目

在跨平台项目中，从共享的JSON Schema快速生成Swift模型定义，保持数据一致性。

扩展知识

Swift的Codable协议是Swift 4引入的类型安全编解码机制，结合Encodable和Decodable两个协议。任何遵循Codable的类型都可以用JSONEncoder编码为JSON数据，用JSONDecoder从JSON数据解码。当Swift属性名与JSON键名不同时（如Swift用驼峰命名isVip而JSON用is_vip），需要定义CodingKeys枚举来映射。可选类型（Type?）是Swift的核心特性，精确区分有值和无值状态，配合Codable可以自动处理JSON中可能缺失的字段。Swift 5.9+的宏（Macro）进一步简化了Codable的使用。