.NET C# 使用 MailKit 实现邮件收发：从安装到实战详解

为什么选 MailKit？

在过去，很多 C# 程序采用系统自带的 System.Net.Mail.SmtpClient 类发送邮件。但随着 .NET Core／.NET 5+的普及，以及现代邮件协议（如 OAuth2、INBOX 访问、IMAP 等）的需求增长，传统方式显得力不从心。
而 MailKit 是一个跨平台、功能强大、官方推荐用于 .NET 现代邮件操作的库。它不仅支持发送邮件，还支持接收（通过 IMAP／POP3）和更先进的认证方式。

安装与项目准备

在你的 C# 项目（控制台、Web API、WinForms/WPF等）中，通过 NuGet 安装 MailKit：

dotnet add package MailKit

在代码文件中引用命名空间：

using MailKit.Net.Smtp;
using MailKit.Net.Imap;
using MailKit.Net.Pop3;
using MimeKit;
using MailKit.Security;

准备一个可用的 SMTP 或 IMAP/POP3 服务，如 Gmail、Outlook、自己架设的邮件服务器等。确保你有正确的服务器地址、端口、用户名、密码／OAuth2 Token。

邮件发送：基础流程

以下为基本的发送流程：

var message = new MimeMessage();
message.From.Add(new MailboxAddress("Sender Name", "sender@example.com"));
message.To.Add(new MailboxAddress("Recipient Name", "recipient@example.com"));
message.Subject = "Test Email Subject";

// 邮件正文为纯文本
message.Body = new TextPart("plain")
{
    Text = "Hello from MailKit in C#!"
};

using var client = new SmtpClient();
client.Connect("smtp.example.com", 587, SecureSocketOptions.StartTls);
client.Authenticate("sender@example.com", "password");
client.Send(message);
client.Disconnect(true);

通过上述代码，完成了一个简单邮件的发送。

邮件发送：高级功能（HTML + 附件 +多收件人）

如果邮件需支持 HTML 格式、带附件或发给多个收件人，则建议使用 BodyBuilder：

var message = new MimeMessage();
message.From.Add(new MailboxAddress("Sender", "sender@example.com"));
message.To.Add(new MailboxAddress("A", "a@example.com"));
message.To.Add(new MailboxAddress("B", "b@example.com"));
message.Subject = "Complex Email";

var builder = new BodyBuilder();
builder.HtmlBody = "<h1>Hello</h1><p>This is an HTML email.</p>";
builder.TextBody = "This is a fallback plain text body.";
builder.Attachments.Add(@"C:\files\document.pdf");

message.Body = builder.ToMessageBody();

using var client = new SmtpClient();
client.Connect("smtp.example.com", 587, SecureSocketOptions.StartTls);
client.Authenticate("sender@example.com", "password");
client.Send(message);
client.Disconnect(true);

此外，还可以进行内嵌图片、多个附件、抄送/密送等操作。

邮件接收：IMAP 或 POP3

MailKit 支持从邮件服务器接收邮件，常见方式有 IMAP 和 POP3。以下以 IMAP 为例：

using var client = new ImapClient();
client.Connect("imap.example.com", 993, SecureSocketOptions.SslOnConnect);
client.Authenticate("user@example.com", "password");

var inbox = client.Inbox;
inbox.Open(FolderAccess.ReadOnly);

Console.WriteLine($"Total messages: {inbox.Count}");
for (int i = 0; i < inbox.Count; i++)
{
    var message = inbox.GetMessage(i);
    Console.WriteLine($"Subject: {message.Subject}");
}

client.Disconnect(true);

使用 POP3 的流程类似，只是连接方式、端口和方法略有不同。

常见问题与解决方案

• 认证失败：尤其使用 Gmail 等服务时，需要开启“应用专用密码”或 OAuth2 验证。
• SSL/TLS 设置错误：使用 SecureSocketOptions 参数时，应根据端口选择适当选项（如 StartTls、SslOnConnect）。
• 垃圾邮件过滤／可达性差：建议为发件域名配置 SPF、DKIM、DMARC，以提升邮件送达率。
• 附件太大或格式复杂：注意 MIME 构建、编码和服务器限制。
• 同步阻塞问题：在 Web 应用中建议使用异步接口如 SendAsync、GetMessageAsync 以避免阻塞。

最佳实践建议

• 将邮件服务配置（如 SMTP 主机、端口、用户名、密码）抽象至配置文件或环境变量，避免硬编码。
• 在发送邮件前增加错误重试机制或日志记录，以应对网络波动或服务不可用情况。
• 对于高并发或大量邮件发送，使用专门的邮件服务／队列机制，不建议在用户请求线程中直接发送。
• 定期监控发信域名的送达情况、退信率、黑名单状态，确保系统稳定。
• 必要时使用 OAuth2 或现代认证方式替代纯用户名+密码，提高安全性。

总结

通过使用 MailKit，C# 开发者可以在 .NET 环境中更加灵活、高效、安全地实现“邮件发送 + 接收”功能。无论是基础通知邮件，还是复杂 HTML／附件／多收件人的场景，都能轻松胜任。掌握上述流程、注意常见坑，并结合最佳实践，你的应用邮件功能即可具备可维护、可扩展的能力。