JSON转Swift

📖 工具说明

在现代 Swift 开发中，利用 Codable 协议进行 JSON 解析已成为标准做法。手动编写嵌套的 struct 极其繁琐且容易在字段命名上出错。本工具支持一键将 JSON 数据 转换为类型严谨、符合 Swift 5+ 规范的 Struct 模型。

1. 核心应用场景

• iOS/macOS App 开发： 快速根据 API 响应生成符合 Codable 协议的数据模型，彻底告别手动编写解析逻辑。
• Server-side Swift (Vapor)： 在后端开发中快速定义 Request 和 Response 的模型结构。
• 代码重构： 将旧的 NSDictionary 解析逻辑重构为强类型、安全的数据类。
• 快速 Mock： 将本地测试用的 JSON 直接生成模型代码，用于 SwiftUI 预览或单元测试。

2. 核心功能解析

本站工具深度适配了 Swift 的语法特性与苹果官方的序列化规范：

A. 智能类型推导 (Sound Typing)

• 基础类型映射： 自动识别 JSON 类型并转换为：String, Int, Double, Bool。
• 可选类型支持 (Optional)： 智能识别 JSON 中的 null 值，自动生成带问号的可空属性（如 String?）。
• 集合映射： 识别数组并生成 [T]，支持多维数组及对象数组的深度解析。

B. 自动生成 Codable 协议

• 一键 Codable： 默认添加 Codable 协议（包含 Encodable 和 Decodable），满足 99% 的网络请求场景。
• CodingKeys 自动映射： 智能识别 JSON 的 snake_case（蛇形）命名，自动生成 enum CodingKeys 并将字段重命名为 Swift 推荐的 camelCase（驼峰）规范。

C. 100% 本地转换 (Privacy & Speed)

• 物理级隐私保护： 所有代码生成逻辑均在您的浏览器本地执行。您的接口地址、核心业务数据或私密 Token 绝不上传服务器。
• 极速响应： 依托高效的本地解析引擎，无论 JSON 嵌套多深，代码生成均在毫秒间完成。

D. 现代 Swift 语法优化

• Struct 优先： 默认生成 struct 而非 class，遵循 Swift 的值类型编程范式。
• 属性修饰： 支持生成 let（常量）或 var（变量）属性定义。

3. 操作流程简述

1. 粘贴内容： 将 JSON 示例数据粘贴至本站的“输入区”。
2. 设置参数：
   • 输入根模型名称 (Root Class Name)，如 UserResponse。
   • 选择是否开启“驼峰转换”。
   • 选择是否包含 CodingKeys。
3. 开始转换： 点击“转换为 Swift”按钮。
4. 一键复制： 点击输出区的“复制代码”，直接粘贴到 Xcode 项目中。

4. 转换代码示例

原始 JSON：

{
  "user_id": 2026,
  "user_name": "Swiftacean",
  "is_pro": true,
  "last_login": null
}

生成的 Swift 代码 (本站处理)：

import Foundation

struct UserResponse: Codable {
    let userID: Int
    let userName: String
    let isPro: Bool
    let lastLogin: String?

    enum CodingKeys: String, CodingKey {
        case userID = "user_id"
        case userName = "user_name"
        case isPro = "is_pro"
        case lastLogin = "last_login"
    }
}

5. 为什么选择本站在线 JSON 转 Swift？

• 减少 Crash 风险： 通过严谨的类型推导和可选类型处理，极大降低因数据类型不匹配导致的解析崩溃。
• 免安装插件： 无需安装庞大的 Xcode 插件或第三方软件，浏览器即开即用，适合快速联调。
• 纯净无广： 针对开发者设计的简约界面，专注提升 Coding 效率。
• 完全免费： 无需注册，不限次数，永久为 Apple 开发者社区提供生产力支持。

📖 相关推荐