免费在线JSON转Swift结构体工具,一键将JSON数据转换为Swift struct和Codable定义,支持嵌套结构体、可选类型、CodingKeys等。无需注册。 | 无需注册 · 数据绝不上传服务器
零依赖·可离线使用一键将JSON数据转换为Swift struct和Codable定义,支持嵌套结构体和CodingKeys
零依赖 · 可离线使用📝 JSON输入
❓ 常见问题
支持嵌套JSON吗?
支持。嵌套对象会自动生成为独立的struct定义。
如何处理null值?
开启"可选类型"后,null字段生成为可选类型(如String?),确保解码时不会崩溃。
支持Codable吗?
支持。默认生成遵循Codable的结构体,可直接配合JSONDecoder使用。
数据会上传到服务器吗?
不会。所有转换在浏览器本地完成,数据绝不离开您的设备。
CodingKeys是什么?
当Swift属性名与JSON键名不同时,CodingKeys枚举提供映射关系,确保编解码正确。
生成的代码可以直接使用吗?
可以。生成的代码符合Swift规范,可直接复制到.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的使用。