如何从Gmail API响应中完整提取邮件发件人、收件人信息？

云原生阿岚

2026-5-27

解决Gmail API获取完整发件人/收件人信息的问题

问题背景

你通过Gmail API获取邮件消息时，发件人（From）和收件人（To）的返回格式如下：

{ "name": "From", "value": "Mail Delivery Subsystem <mailer-daemon@googlemail.com>" }
{ "name": "To", "value": "Rahul, kumar <rahulkumar1234@gmail.com>" }

但用Swift循环遍历并输出时，内容被截断，只显示类似「From ::: Mail D...」的部分，代码如下：

if element.name == "From" { 
    print("From ::: \(String(describing: element.value!))") 
}

解决方案

出现截断的原因通常有两个：要么是你获取字符串的方式不对，要么是控制台输出本身有限制，下面是对应的解决办法：

1. 直接获取完整的字符串值

String(describing:)方法会生成对象的描述字符串，对于一些包装类或者长字符串，可能会自动截断。你需要确保直接将element.value转换为String类型后再使用，而不是依赖String(describing:)：

if element.name == "From" {
    // 安全解包并转换为String类型
    guard let fromValue = element.value as? String else {
        print("无法获取发件人信息")
        return
    }
    print("From ::: \(fromValue)")
}

2. 调整控制台输出限制

如果上面的修改后还是显示截断，那可能是Xcode控制台默认限制了输出长度。你可以通过两种方式解决：

用debugPrint代替print，它会输出更完整的内容：
```
debugPrint("From ::: \(fromValue)")
```
修改Xcode的运行配置：打开Edit Scheme → Run → Arguments，在Environment Variables中添加OS_ACTIVITY_DT_MODE，值设为disable，这样控制台就会输出完整内容。