smtpclient 发送邮件需配置正确服务器、端口、凭据并启用 ssl/tls；.net core 5+ 已过时但可用，推荐 mailkit；html 邮件须设 isbodyhtml=true、用内联样式和 table 布局；附件需注意流生命周期和中文名编码；排查错误优先检查网络、授权码、tls 版本。
用 SmtpClient 发送纯文本邮件最简单
只要 SMTP 服务器地址、端口、账号密码正确，几行代码就能发出去。注意 .NET Core 5+ 已将 SmtpClient 标记为“过时”，但目前仍可正常使用；若用 .NET 6+ 且追求长期维护，建议迁移到第三方库（如 MailKit），不过对内部通知类小项目，SmtpClient 足够快、够稳。
关键点：
-
SmtpClient默认不启用 SSL/TLS，但现代邮箱（Gmail、Outlook、腾讯企业邮）基本要求EnableSsl = true - 端口不是固定 25：Gmail 用 587（STARTTLS），部分服务器用 465（SSL）
- 发件人邮箱必须和
Credentials的用户名一致，否则多数 SMTP 服务会拒信 - 别把密码硬编码在代码里——用
ConfigurationManager或IConfiguration读取
var client = new SmtpClient("smtp.qq.com")
{
Port = 587,
Credentials = new NetworkCredential("your@qq.com", "your-app-password"),
EnableSsl = true
};
var mail = new MailMessage
{
From = new MailAddress("your@qq.com"),
Subject = "测试邮件",
Body = "这是一封纯文本邮件",
IsBodyHtml = false
};
mail.To.Add("target@example.com");
client.Send(mail);
发送 HTML 邮件要设 IsBodyHtml = true 并注意内联样式
HTML 邮件在客户端渲染差异大，<style></style> 标签和外部 CSS 基本无效，必须用 style="..." 写内联样式。图片尽量用绝对 URL（https:// 开头），避免引用本地路径或相对路径。
常见陷阱：
- 忘记设
IsBodyHtml = true→ 邮件正文显示原始 HTML 标签 - 用了
<div> 或 Flex 布局 → 多数邮箱客户端（尤其是 Outlook）不支持，推荐用老式 <code><table> 布局 <li>字体写 <code>font-family: 'Segoe UI', sans-serif→ 安全字体只写Verdana, Arial, Helvetica, sans-serif
mail.Body = "<p style=\"color:#333;font-family:Verdana,Arial,sans-serif\">欢迎<strong>注册</strong>！</p>"; mail.IsBodyHtml = true;
带附件时用 Attachment 类，注意文件流不能被提前释放
附件本质是内存或磁盘上的字节流，添加到 MailMessage.Attachments 后，SmtpClient.Send() 期间会读取它。如果用 new Attachment(File.OpenRead(...))，文件流可能在发送前就被 GC 关闭。
专为中小型企业定制的网络办公软件,富有竞争力的十大特性： 1、独创 web服务器、数据库和应用程序全部自动傻瓜安装，建立企业信息中枢 只需3分钟。 2、客户机无需安装专用软件，使用浏览器即可实现全球办公。 3、集成Internet邮件管理组件，提供web方式的远程邮件服务。 4、集成语音会议组件，节省长途话费开支。 5、集成手机短信组件，重要信息可直接发送到员工手机。 6、集成网络硬
稳妥做法：
- 用
new Attachment(string fileName)构造器（自动管理流） - 若需动态生成内容（比如导出 Excel），先写入
MemoryStream，再传给Attachment，并确保该流在Send()完成前未被Dispose() - 附件名含中文？用
Attachment.NameEncoding = Encoding.UTF8防止乱码
var attachment = new Attachment(@"C:\report.pdf"); attachment.NameEncoding = Encoding.UTF8; mail.Attachments.Add(attachment);
SmtpClient.Send() 报错常见原因和快速排查
错误信息往往模糊，比如 “Failure sending mail” 或 “Unable to connect to the remote server”，实际原因可能差很远。
优先检查这几项：
- 网络连通性：
telnet smtp.qq.com 587（Windows）或nc -zv smtp.qq.com 587（Linux/macOS）看是否能通端口 - 密码是否为“授权码”而非邮箱登录密码（QQ 邮箱、163 邮箱必须开 POP3/SMTP 并生成专用密码）
- 防火墙或公司代理是否拦截了出站 SMTP 流量
- .NET 版本是否太低（.NET Framework 4.0+ 支持 TLS 1.2，旧版本默认只启 TLS 1.0，而 Gmail 等已禁用）→ 可加
ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12;
真正麻烦的是异步发送失败后没异常抛出——SmtpClient 的 SendAsync 在出错时只会触发 SendCompleted 事件，且 e.Error 为 null，得靠日志或调试器捕获真实异常。
