如何在Python Gmail API中修改发件人显示名称？

安全阿岳

2026-5-28

问题：Gmail API发送邮件时无法显示自定义发件人名称

我正在开发一个新成绩提醒邮件脚本，当有新成绩时会给我发送邮件。目前所有功能都正常，唯独发件人显示为我的邮箱地址而非自定义名称。

我已经尝试将发件人设置为"John Smith" <from@email.com>和John Smith <from@email.com>的格式，但问题仍未解决，请问该如何修复？

以下是我的代码：

from __future__ import print_function
from apiclient.discovery import build
from httplib2 import Http
from oauth2client import file, client, tools
from email.mime.text import MIMEText
import base64

def create_message(sender, to, subject, message_text):
    """Create a message for an email.
    Args:
      sender: Email address of the sender.
      to: Email address of the receiver.
      subject: The subject of the email message.
      message_text: The text of the email message.
    Returns:
      An object containing a base64url encoded email object.
    """
    message = MIMEText(message_text)
    message['to'] = to
    message['from'] = sender
    message['subject'] = subject
    return {'raw': base64.urlsafe_b64encode(message.as_string().encode("utf-8")).decode()}

def send_message(message):
    global service
    user_id = "me"
    """Send an email message.
    Args:
      service: Authorized Gmail API service instance.
      user_id: User's email address. The special value "me" can be used to indicate the authenticated user.
      message: Message to be sent.
    Returns:
      Sent Message.
    """
    try:
        message = (service.users().messages().send(userId=user_id, body=message).execute())
        return message
    except exception as error:
        # I am aware this line is broken, but it does goes through successfully so this does not execute
        print('An error occurred: %s' % error)

# Setup the Gmail API
SCOPES = 'https://www.googleapis.com/auth/gmail.send'
store = file.Storage('credentials.json')
creds = store.get()
if not creds or creds.invalid or creds == "None":
    flow = client.flow_from_clientsecrets('client_secret.json', SCOPES)
    creds = tools.run_flow(flow, store)
service = build('gmail', 'v1', http=creds.authorize(Http()))

msg = create_message("fname lname", "to@email.com", '', content)
send_message(msg)

解决方案

别着急，这个问题其实是发件人格式和参数传递的小问题，我们一步步来修复：

第一步：用标准格式设置发件人
邮件协议里，正确的发件人格式应该是"自定义名称" <你的邮箱地址>，这里的英文双引号很重要，它能告诉邮件客户端正确区分显示名称和实际邮箱地址。你之前尝试的格式可能因为缺少引号或者没有同时包含名称和邮箱导致解析失败。
第二步：修复调用create_message的参数
看你代码最后一行调用create_message("fname lname", ...)，这里只传了名称，没带你的实际邮箱地址——Gmail API必须知道要从哪个已授权的邮箱发件，只给名称是不行的。你需要把sender参数改成同时包含名称和邮箱的格式，比如：
```
msg = create_message('"成绩提醒助手" <your-real-email@example.com>', "to@email.com", '新成绩提醒', content)
```
额外注意Gmail的小限制
如果你用的是Gmail账号，Gmail会确保发件人邮箱是你已经验证过的（也就是你授权API使用的那个邮箱），但自定义名称是完全可以正常显示的。如果还是看不到名称，检查下你的收件邮箱客户端有没有开启“仅显示邮箱地址”的设置，有些客户端默认会隐藏显示名称。

另外，你的send_message函数里有个小bug：except exception as error应该改成except Exception as error（Exception首字母要大写），虽然你说目前不会触发，但修复它能避免后续调试时的麻烦。

这样修改之后，收件人就能看到你设置的自定义发件人名称，而不是纯邮箱地址啦！

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