如何用emailjs快速实现Node.js邮件发送？超简单教程让你5分钟上手！
项目地址: https://gitcode.com/gh_mirrors/em/emailjs emailjs是一个轻量级的JavaScript库，专为Node.js环境设计，能帮助开发者轻松通过SMTP服务器发送HTML邮件和附件。无论是用户注册通知、自动化报告还是订单确认，它都能让邮件发送流程变得简单高效。
📌 为什么选择emailjs？核心优势解析
✅ 极简API设计，3行代码搞定邮件发送
告别复杂的SMTP协议配置，emailjs封装了底层通信细节，让你专注于业务逻辑实现。通过直观的配置对象和链式调用，即使是新手也能快速上手。
✅ 全功能支持，满足企业级需求
- 多格式内容：同时支持纯文本（text）和富文本（HTML）邮件
- 灵活附件系统：支持本地文件、二进制数据和在线资源三种附件类型
- 全面认证机制：兼容PLAIN、LOGIN和XOAUTH2等主流SMTP认证方式
- 异步友好：原生支持Promise和async/await语法，完美融入现代Node.js开发流程
🚀 快速开始：5分钟上手实战
1️⃣ 环境准备与安装
确保已安装Node.js（v12+推荐），通过以下命令快速安装emailjs：
# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/em/emailjs
# 进入项目目录
cd emailjs
# 安装依赖（如使用TypeScript需额外安装类型定义）
npm install
2️⃣ 基础配置：连接SMTP服务器
创建配置对象时，需提供SMTP服务器信息和认证凭证。以下是主流邮箱服务商的配置示例：
const email = require('emailjs');
// 创建SMTP服务器连接
const server = email.server.connect({
user: "your_email@example.com", // 邮箱账号
password: "your_app_password", // 授权码（非登录密码）
host: "smtp.example.com", // SMTP服务器地址
ssl: true // 是否启用SSL加密（推荐true）
});
3️⃣ 发送第一个邮件：文本+HTML混合内容
下面示例展示如何发送包含纯文本正文、HTML内容和附件的完整邮件：
// 邮件发送配置
const message = {
text: "这是纯文本内容，用于不支持HTML的邮件客户端",
from: "发送者 <your_email@example.com>",
to: "收件人 <recipient@example.com>",
cc: "抄送 <cc@example.com>",
subject: "使用emailjs发送的测试邮件",
attachment: [
// HTML内容附件（alternative: true表示作为替代内容）
{data: "<h1>Hello!</h1><p>这是<b>HTML格式</b>的邮件内容</p>", alternative: true},
// 本地文件附件
{path: "test/attachments/smtp.txt", name: "邮件说明.txt"},
// 二进制数据附件
{data: Buffer.from("自定义内容"), type: "text/plain", name: "data.txt"}
]
};
// 执行发送并处理结果
server.send(message, (err, msg) => {
if (err) {
console.error("发送失败:", err);
} else {
console.log("发送成功:", msg);
}
});
4️⃣ 高级功能：异步处理与错误捕获
使用Promise API实现更优雅的异步流程控制：
// 使用async/await语法
async function sendEmail() {
try {
const result = await server.send(message);
console.log("发送成功:", result);
} catch (err) {
console.error("发送失败:", err);
}
}
sendEmail();
📁 项目结构解析与核心模块
emailjs采用模块化设计，核心功能分布在以下目录：
- smtp/: SMTP协议实现核心
client.ts: 邮件客户端逻辑connection.ts: 网络连接管理message.ts: 邮件内容构建器
- test/attachments/: 测试用附件资源
- email.ts: 主入口文件，导出核心API
💡 避坑指南：常见问题解决方案
🔒 授权码配置问题
多数邮箱服务商（如QQ、网易）要求使用"应用专用密码"而非登录密码：
- 在邮箱设置中开启SMTP服务
- 生成第三方应用授权码
- 将授权码填入password字段
🕒 连接超时或发送失败
- 检查SMTP服务器地址和端口（SSL通常465，非SSL 587）
- 确认服务器是否支持所选认证方式
- 尝试关闭防火墙或添加端口例外规则
📎 附件路径问题
本地附件需提供绝对路径或相对于当前工作目录的相对路径，建议使用path模块处理路径：
const path = require('path');
{path: path.join(__dirname, 'files/report.pdf'), name: "月度报告.pdf"}
📈 实际应用场景与案例
📧 用户注册流程中的验证邮件
// 发送注册验证码
function sendVerificationEmail(userEmail, code) {
return server.send({
text: `您的注册验证码是: ${code}`,
from: "系统通知 <noreply@example.com>",
to: userEmail,
subject: "【邮箱验证】请完成您的账号注册",
attachment: [
{data: `<h2>欢迎注册！</h2><p>您的验证码：<b>${code}</b></p>`, alternative: true}
]
});
}
📊 自动化数据报告发送
结合node-schedule实现定时发送：
const schedule = require('node-schedule');
// 每周一上午9点发送周报
schedule.scheduleJob('0 9 * * 1', () => {
server.send({
from: "报表系统 <report@example.com>",
to: "manager@example.com",
subject: `【周报】${new Date().toLocaleDateString()}业务数据`,
attachment: [
{path: "reports/weekly.pdf", name: "业务周报.pdf"}
]
});
});
📝 小结：让邮件发送变得简单高效
emailjs以其简洁的API设计和完善的功能支持，成为Node.js邮件发送的优选方案。无论是小型项目的简单通知，还是企业级应用的复杂邮件需求，它都能提供稳定可靠的解决方案。通过本教程的学习，你已经掌握了从环境搭建到高级应用的全部知识，现在就动手试试吧！
想要深入了解更多功能？可以查看项目中的测试用例文件test/message.ts，里面包含了各种高级用法示例。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
