使用Javax Mail读取Gmail邮件时能否为邮件添加自定义标签？

结论：完全可以实现，不需要接入Gmail专属API，基于标准IMAP能力即可完成

Gmail的标签体系和标准IMAP协议做了原生映射：所有自定义标签、系统分类都会被映射为IMAP下的独立文件夹，Javax Mail（Jakarta Mail）原生支持IMAP协议的邮件文件夹操作，正好可以匹配这个映射规则实现标签管理，你之前用的读邮件的连接配置可以直接复用，不需要额外调整连接参数。

实现核心规则 #

• 给邮件加标签 = 将目标邮件复制到对应标签映射的IMAP文件夹下，操作后原邮件在收件箱/其他分类下的副本不会被删除，Gmail侧会直接识别为给原邮件打上对应标签
• 移除邮件标签 = 从对应标签映射的IMAP文件夹下删除该邮件副本，不会影响邮件在其他文件夹的存在
• 新建自定义标签 = 通过Javax Mail的文件夹接口创建同名IMAP文件夹，Gmail会自动将其识别为自定义标签，不需要在网页端提前创建
• 注意不要和Gmail系统内置标签（星标、重要、垃圾邮件、已发送等）的默认映射名重名，避免出现操作异常

最简实现代码示例 #

// 前置：你已经完成IMAP连接，拿到了Store实例store，以及要打标签的目标邮件对象message
// 1. 指定自定义标签名称，例如"待跟进客户"
String labelName = "待跟进客户";
Folder labelFolder = store.getFolder(labelName);

// 2. 标签不存在则自动创建
if (!labelFolder.exists()) {
    labelFolder.create(Folder.HOLDS_MESSAGES);
}

// 3. 以读写模式打开标签对应文件夹
labelFolder.open(Folder.READ_WRITE);

// 4. 复制邮件到标签文件夹，完成打标
message.getFolder().copyMessages(new Message[]{message}, labelFolder);

// 5. 关闭文件夹资源，不需要保存修改标记
labelFolder.close(false);

踩坑提示 #

不要直接往标签文件夹里追加新构建的邮件对象，会导致Gmail生成全新的邮件副本，丢失原邮件的会话线程、已读状态等属性，必须通过copyMessages方法操作已经存在的邮件实例，才能正确实现标签添加效果。
如果要给多封邮件批量打标签，直接把多封邮件放到Message数组里传入copyMessages即可，性能比单封循环操作高很多。

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