如何使用NW.js桌面应用编写带HTML正文的邮件？

核心问题根因 #

HTML正文无法在邮件客户端正常展示，通常由三类问题导致：

• 调用发信接口/邮件客户端时未指定内容类型为text/html，内容被强制作为纯文本解析
• HTML内容的样式、布局、资源不符合邮件客户端兼容规范，被客户端过滤或渲染失败
• NW.js传递HTML参数时未做特殊字符转义，导致内容截断、格式错乱

NW.js端实现步骤 #

你可以直接在NW.js中集成Node.js生态的邮件处理模块实现需求，以下是两种常用场景的实现方式：

场景1：调用本地默认邮件客户端生成可编辑草稿 #

使用nodemailer对接系统MAPI接口实现，无需配置SMTP信息，直接唤起本地已登录的邮件客户端生成草稿：

1. 项目中安装依赖：npm install nodemailer nodemailer-sendmail-transport --save
2. 功能实现代码示例：

const nodemailer = require('nodemailer');
const sendmailTransport = require('nodemailer-sendmail-transport');

// 初始化传输器
const transporter = nodemailer.createTransport(sendmailTransport());

// 邮件参数配置
const mailOptions = {
  from: '你的发件人地址',
  to: '收件人地址',
  subject: '邮件标题',
  // 这里传入你生成的HTML正文内容
  html: '<div style="font-size:14px;">测试HTML邮件内容</div>',
  // 可选：配置纯文本降级内容，供不支持HTML的客户端展示
  text: '纯文本降级内容'
};

// 生成草稿（如果需要直接发送可替换为transporter.sendMail）
transporter.sendMail(mailOptions, (error, info) => {
  if (error) {
    console.log('草稿生成失败：', error);
    return;
  }
  console.log('草稿生成成功');
});

场景2：通过SMTP服务直接生成/发送邮件 #

适合需要后台静默生成草稿、不需要唤起本地客户端的场景：

1. 安装依赖：npm install nodemailer --save
2. 功能实现代码示例：

const nodemailer = require('nodemailer');

// 配置SMTP传输器，以QQ邮箱为例，其他邮箱替换对应配置即可
const transporter = nodemailer.createTransport({
  host: 'smtp.qq.com',
  port: 465,
  secure: true,
  auth: {
    user: '你的邮箱地址',
    pass: '你的邮箱授权码'
  }
});

const mailOptions = {
  from: '你的发件人地址',
  to: '收件人地址',
  subject: '邮件标题',
  html: '你的HTML正文内容',
  text: '纯文本降级内容'
};

// 生成草稿或直接发送
transporter.sendMail(mailOptions, (error, info) => {
  if (error) {
    console.log('操作失败：', error);
    return;
  }
  console.log('操作成功');
});

HTML邮件兼容规范 #

要保证HTML正文在所有邮件客户端正常显示，必须遵循以下规则：

• 所有CSS样式必须写行内样式，禁止使用外部样式表、head区域的style标签，多数邮件客户端会过滤非行内的样式规则
• 布局使用table标签实现，禁止使用flex、grid等现代CSS布局，兼容Outlook等老旧客户端
• 图片资源必须使用公网可访问的绝对URL，禁止使用相对路径、base64格式嵌入，多数客户端会拦截本地资源和base64内容
• 禁止使用script、iframe、form等可执行或交互类标签，所有HTML特殊字符要提前做转义处理

排障方法 #

如果仍出现显示异常，按以下顺序排查：

1. 单独导出你生成的HTML内容为本地.html文件，直接拖入邮件客户端正文编辑区，确认HTML本身可正常渲染，排除内容兼容问题
2. 打印NW.js传递给发信接口的HTML字符串，确认内容没有被转义、截断，完整度符合预期
3. 发信时强制指定字符编码为UTF-8，避免乱码问题

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