ios怎么设置json的编码格式

iOS中如何设置JSON的编码格式

在iOS开发中，JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，被广泛应用于前后端数据交互，由于JSON对字符编码的严格要求（默认使用UTF-8），开发者有时需要显式处理编码格式，以确保数据解析的正确性（尤其是处理非ASCII字符时），本文将详细介绍iOS中设置JSON编码格式的方法，涵盖原生JSONSerialization、第三方库SwiftyJSON以及网络请求中的编码处理。

JSON编码格式的基础知识

JSON标准规定，文本内容必须采用UTF-8编码（或UTF-16/UTF-32，但UTF-8是主流），iOS中，String类型默认使用UTF-16编码，而JSONSerialization在序列化/反序列化时会自动处理编码转换，确保符合JSON标准，开发者通常无需手动“设置”JSON的编码格式，但需要确保：

1. 序列化时，String中的非ASCII字符（如中文、emoji）能正确转换为UTF-8编码的JSON字符串；
2. 反序列化时，从服务器获取的JSON数据（即使原始编码是UTF-8）能正确解析为String类型。

使用JSONSerialization处理JSON编码

JSONSerialization是iOS提供的原生JSON处理类，支持将JSONSerialization对象（如Dictionary、Array）转换为JSON格式的Data（序列化），或将JSON格式的Data转换为JSONSerialization对象（反序列化），其编码处理的核心是自动UTF-8转换,但开发者可通过参数确保数据正确性。

序列化：将对象转为JSON（确保UTF-8编码）

序列化时，JSONSerialization会自动将String中的字符转换为UTF-8编码，处理中文时无需额外操作，但需确保对象类型符合JSON标准（String、Number、Bool、Array、Dictionary）。

示例代码：序列化中文JSON

import Foundation
// 1. 准备可序列化的对象（包含中文）
let dataObject: [String: Any] = [
    "name": "张三",
    "age": 25,
    "city": "北京",
    "hobbies": ["编程", "阅读"]
]
// 2. 序列化为JSON Data（自动使用UTF-8编码）
guard let jsonData = try? JSONSerialization.data(withJSONObject: dataObject, options: .prettyPrinted) else {
    print("序列化失败")
    exit(1)
}
// 3. 验证编码（jsonData默认为UTF-8）
if let jsonString = String(data: jsonData, encoding: .utf8) {
    print("JSON字符串（UTF-8编码）: \(jsonString)")
    // 输出：JSON字符串（UTF-8编码）: {
    //   "age" : 25,
    //   "city" : "北京",
    //   "hobbies" : [
    //     "编程",
    //     "阅读"
    //   ],
    //   "name" : "张三"
    // }
}

关键参数说明：

• options: 用于控制输出格式，如.prettyPrinted（格式化，便于阅读），不影响编码格式。
• data的编码：JSONSerialization.data()返回的Data对象默认为UTF-8编码,可直接用于网络请求或文件存储。

反序列化：将JSON转为对象（处理UTF-8数据）

反序列化时，需确保传入的Data是UTF-8编码的JSON数据，如果服务器返回的数据编码不是UTF-8（如GBK），需先转换为UTF-8再解析。

示例代码：反序列化UTF-8 JSON

import Foundation
// 假设从服务器获取的JSON Data（UTF-8编码）
let serverJsonData = """
{
    "name": "李四",
    "city": "上海"
}
""".data(using: .utf8)!
// 反序列化为对象
guard let jsonObject = try? JSONSerialization.jsonObject(with: serverJsonData, options: []) else {
    print("反序列化失败")
    exit(1)
}
if let name = jsonObject as? String, let city = jsonObject as? String {
    print("姓名: \(name), 城市: \(city)") // 输出：姓名: 李四, 城市: 上海
}

异常处理：非UTF-8编码的JSON

如果服务器返回的JSON数据是GBK编码（如部分国内旧接口），直接用JSONSerialization解析会失败，此时需先转换为UTF-8：

import Foundation
// 假设服务器返回GBK编码的Data
let gbkJsonData = "{'name': '王五'}".data(using: .gbk)!
// 1. 将GBK编码的Data转换为UTF-8编码的Data
guard let utf8Data = String(data: gbkJsonData, encoding: .gbk)?.data(using: .utf8) else {
    print("编码转换失败")
    exit(1)
}
// 2. 反序列化UTF-8 Data
guard let jsonObject = try? JSONSerialization.jsonObject(with: utf8Data, options: []) else {
    print("反序列化失败")
    exit(1)
}
print(jsonObject) // 输出：["name": "王五"]

使用第三方库SwiftyJSON处理编码

SwiftyJSON是iOS开发中常用的JSON解析库，简化了JSONSerialization的复杂操作，其编码处理逻辑与原生类一致，同样依赖UTF-8编码。

序列化（需转换为JSON Data）

SwiftyJSON本身不直接提供序列化方法，但可通过JSONSerialization结合使用：

import SwiftyJSON
// 1. 创建JSON对象
let json = JSON([
    "name": "赵六",
    "age": 30
])
// 2. 转换为JSON Data（UTF-8编码）
guard let jsonData = json.rawData() else {
    print("序列化失败")
    exit(1)
}
if let jsonString = String(data: jsonData, encoding: .utf8) {
    print("JSON字符串: \(jsonString)") // 输出：JSON字符串: {"name":"赵六","age":30}
}

反序列化（自动处理UTF-8）

import SwiftyJSON
let jsonData = """
{
    "name": "钱七",
    "city": "广州"
}
""".data(using: .utf8)!
let json = JSON(jsonData)
print("姓名: \(json["name].string), 城市: \(json["city].string)")
// 输出：姓名: 钱七, 城市: 广州

网络请求中的JSON编码处理

在实际开发中，JSON数据通常通过HTTP请求传输（如URLSession），需确保请求/响应的编码格式正确。

发送JSON请求（设置请求体编码）

使用URLSession发送POST/PUT请求时，需将请求体设置为JSON格式的Data（UTF-8编码），并指定Content-Type为application/json; charset=utf-8：

import Foundation
let url = URL(string: "https://api.example.com/user")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("application/json; charset=utf-8", forHTTPHeaderField: "Content-Type")
// 准备JSON Data（UTF-8编码）
let payload: [String: Any] = ["name": "孙八", "email": "sunba@example.com"]
guard let jsonData = try? JSONSerialization.data(withJSONObject: payload, options: []) else {
    print("JSON序列化失败")
    exit(1)
}
request.httpBody = jsonData
// 发送请求
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print("请求失败: \(error)")
        return
    }
    guard let data = data else {
        print("无响应数据")
        return
    }
    print("响应数据（UTF-8）: \(String(data: data, encoding: .utf8) ?? "无法解码")")
}
task.resume()

接收JSON响应（处理服务器编码）

服务器返回的响应头可能包含Content-Type字段，如Content-Type: application/json; charset=utf-8，若未明确指定charset，默认按UTF-8处理；若服务器使用其他编码（如GBK）,需手动转换：

import Foundation
let url = URL(string: "https://api.example.com/data")!
let task = URLSession.shared.dataTask(with: url) { data, response, error in
    if let error = error {
        print("请求失败: \(error)")
        return
    }
    guard let data = data, let httpResponse = response as? HTTPURLResponse else {
        print("无响应数据")
        return