使用Nodemailer发件时，能否根据收件端邮件客户端是否为富文本提供不同内容？

核心思路是同时提供纯文本版和富文本版的邮件内容，收件端的邮件客户端会自动根据自身能力选择显示对应版本——这完全符合邮件协议（MIME）的规范，Nodemailer也原生支持这个功能。

为什么这个方案可行？ #

邮件协议允许在同一封邮件中包含多个"MIME部分"：

• 纯文本客户端（比如老旧的终端邮件工具、部分极简邮件APP）只能解析text/plain类型的内容，会直接显示纯文本版本
• 现代富文本客户端（Gmail、Outlook、Apple Mail等）会优先渲染text/html版本，同时也支持用户手动切换到纯文本视图

你不需要主动检测收件端的客户端类型，只需要提供两个版本的内容，剩下的交给客户端自己判断即可。

用Nodemailer实现的代码示例 #

只需要在mailOptions里同时配置text和html字段：

const nodemailer = require('nodemailer');

// 初始化邮件传输器（替换成你的SMTP配置）
const transporter = nodemailer.createTransport({
  host: 'smtp.your-domain.com',
  port: 587,
  secure: false,
  auth: {
    user: 'your-email@your-domain.com',
    pass: 'your-email-password'
  }
});

// 配置双版本邮件内容
const mailOptions = {
  from: 'Your Team <noreply@your-domain.com>',
  to: 'user@example.com',
  subject: '你的订单已确认',
  // 给基础客户端的纯文本版本：简洁、完整的核心信息
  text: `
    嘿，感谢你的下单！
    订单号：#12345
    商品：XX无线耳机
    预计送达时间：2024年6月15日
    查看订单详情：your-domain.com/orders/12345
  `.trim(),
  // 给富文本客户端的增强版本：带样式、图片、交互
  html: `
    <div style="font-family: 'Segoe UI', Arial, sans-serif; max-width: 600px; margin: 0 auto; padding: 20px; border: 1px solid #eee; border-radius: 8px;">
      <h2 style="color: #2d3748; margin-top: 0;">嘿，你的订单已确认！</h2>
      <div style="padding: 15px; background-color: #f7fafc; border-radius: 6px; margin: 20px 0;">
        <p style="margin: 5px 0;"><strong>订单号：</strong>#12345</p>
        <p style="margin: 5px 0;"><strong>商品：</strong>XX无线耳机</p>
        <p style="margin: 5px 0;"><strong>预计送达：</strong>2024年6月15日</p>
      </div>
      <a href="your-domain.com/orders/12345" style="display: inline-block; padding: 10px 20px; background-color: #3182ce; color: white; text-decoration: none; border-radius: 4px;">查看订单详情</a>
      <p style="color: #718096; font-size: 14px; margin-top: 20px;">如果无法点击链接，请复制上面的URL到浏览器打开</p>
    </div>
  `
};

// 发送邮件
transporter.sendMail(mailOptions, (error, info) => {
  if (error) {
    console.error('邮件发送失败:', error);
    return;
  }
  console.log('邮件发送成功:', info.response);
});

关键注意事项 #

• 纯文本版不能偷懒：必须包含完整的核心信息，不能只写"请用富文本客户端查看"——有些用户可能因为隐私设置、设备限制只能访问纯文本内容
• HTML版要做兼容性：不同邮件客户端对CSS的支持差异很大（比如Outlook对flexbox支持极差），建议用表格布局保证兼容，或者使用MJML这类邮件模板框架简化开发
• 不要尝试主动检测客户端：SMTP协议在发送阶段无法获取收件端的客户端信息，双版本方案是唯一可靠的自适应方式

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