Nodemailer 项目教程

1. 项目介绍

Nodemailer 是一个基于 Node.js 的邮件发送库，旨在简化从 Node.js 应用程序发送电子邮件的过程。它支持多种邮件传输协议，包括 SMTP、Sendmail 和 Amazon SES，并且可以轻松集成到任何 Node.js 项目中。Nodemailer 的设计理念是“简单如蛋糕”，使得开发者可以快速上手并高效地发送邮件。

2. 项目快速启动

安装 Nodemailer

首先，你需要在你的 Node.js 项目中安装 Nodemailer。你可以使用 npm 或 yarn 来安装：

npm install nodemailer

或者

yarn add nodemailer

发送第一封邮件

以下是一个简单的示例，展示如何使用 Nodemailer 发送一封邮件：

const nodemailer = require('nodemailer');

// 创建一个 SMTP 传输对象
let transporter = nodemailer.createTransport({
    host: 'smtp.example.com',
    port: 587,
    secure: false, // true for 465, false for other ports
    auth: {
        user: '[e-mail]', // 你的邮箱用户名
        pass: 'password' // 你的邮箱密码
    }
});

// 邮件选项
let mailOptions = {
    from: '"你的名字" <[e-mail]>', // 发件人地址
    to: '[e-mail]', // 收件人地址
    subject: 'Hello ✔', // 邮件主题
    text: '这是一封测试邮件', // 纯文本内容
    html: '<b>这是一封测试邮件</b>' // HTML 内容
};

// 发送邮件
transporter.sendMail(mailOptions, (error, info) => {
    if (error) {
        return console.log(error);
    }
    console.log('邮件已发送: %s', info.messageId);
});

运行代码

将上述代码保存为一个 JavaScript 文件（例如 sendMail.js），然后在终端中运行：

node sendMail.js

如果一切顺利，你应该会收到一封测试邮件。

3. 应用案例和最佳实践

应用案例

• 用户注册确认邮件：在用户注册后，发送一封确认邮件，包含激活链接。
• 密码重置邮件：当用户忘记密码时，发送一封包含重置链接的邮件。
• 新闻通讯：定期向订阅用户发送新闻通讯。

最佳实践

• 使用环境变量：不要在代码中硬编码邮箱凭据，建议使用环境变量来存储敏感信息。
• 错误处理：在发送邮件时，务必处理可能出现的错误，如网络问题或邮箱服务器拒绝连接。
• 异步发送：使用异步方式发送邮件，以避免阻塞主线程。

4. 典型生态项目

• EmailEngine：一个自托管的邮件网关，允许通过 REST 请求与 IMAP 和 SMTP 服务器交互。EmailEngine 还支持 OAuth2、延迟发送、打开和点击跟踪、退信检测等功能。
• Mailtrap：一个用于开发和测试的邮件捕获服务，可以帮助你在开发过程中捕获和检查发送的邮件，而不会真正发送给用户。
• SendGrid：一个强大的电子邮件发送服务，提供丰富的 API 和 SDK，支持大规模邮件发送和分析。

通过这些生态项目，你可以进一步扩展 Nodemailer 的功能，满足更复杂的邮件发送需求。