JSONDecoder与转义换行符：何时将其转为真实换行？

问题背景 #

直接使用JSONDecoder解码包含转义换行符\n的JSON时，解码后的字符串会保留原转义格式（比如输出value\nvalue），手动调用replacingOccurrences逐个处理太繁琐，需要全局统一处理的方案。

通用处理方案 #

方案1：扩展KeyedDecodingContainer全局自动处理

直接扩展JSON解码的容器逻辑，让所有字符串类型字段在解码时自动替换转义换行符，无需修改现有模型：

extension KeyedDecodingContainer {
    func decode(_ type: String.Type, forKey key: Key) throws -> String {
        let rawString = try decode(String.self, forKey: key)
        return rawString.replacingOccurrences(of: "\\n", with: "\n")
    }
}

使用时直接用默认的JSONDecoder即可，所有字符串字段都会自动完成转义替换。

方案2：自定义字符串Wrapper实现精细化控制

如果需要针对特定字段处理，或者不想全局生效，可以定义一个包装类型来处理字符串解码：

struct NewlineProcessedString: Codable {
    let value: String
    
    init(from decoder: Decoder) throws {
        let container = try decoder.singleValueContainer()
        let rawString = try container.decode(String.self)
        self.value = rawString.replacingOccurrences(of: "\\n", with: "\n")
    }
}

// 模型中使用该包装类型
struct MyResponseModel: Codable {
    let content: NewlineProcessedString
    let otherRawString: String // 该字段不会处理转义换行
}

// 解码后直接取value即可
let decodedModel = try JSONDecoder().decode(MyResponseModel.self, from: jsonData)
print(decodedModel.content.value) // 已替换为真实换行符

方案3：解码前预处理JSON文本

如果需要对整个JSON响应做全局替换，可以先把JSON数据转成字符串处理后再解码：

// 假设已获取到JSON数据jsonData
guard var jsonString = String(data: jsonData, encoding: .utf8) else {
    // 处理数据转字符串失败的情况
    return
}
// 替换所有转义换行符
jsonString = jsonString.replacingOccurrences(of: "\\n", with: "\n")
guard let processedData = jsonString.data(using: .utf8) else {
    return
}
// 用处理后的数据解码
let result = try JSONDecoder().decode([String: String].self, from: processedData)

注意：这种方式会替换JSON中所有的\\n，如果业务中存在需要保留转义的场景（比如代码片段、配置文本），不建议使用。

方案选择 #

• 优先选方案1：零侵入现有模型，全局自动生效，最省心。
• 需要精细化控制时选方案2：灵活指定哪些字段需要处理。
• 仅针对特定响应做全局处理时选方案3：适合一次性场景，但要注意误替换风险。

内容的提问来源于stack exchange，提问作者matt