名称： email-best-practices
描述： 适用于构建邮件功能、邮件进入垃圾箱、高退信率、设置 SPF/DKIM/DMARC 认证、实施邮件捕获、确保合规性（CAN-SPAM、GDPR、CASL）、处理 Webhook、重试逻辑，或区分事务性邮件与营销邮件的场景。

邮件最佳实践

构建可送达、合规且用户友好的邮件的指导。

架构概览

[用户] → [邮件表单] → [验证] → [双重确认订阅]
                                              ↓
                                    [记录同意]
                                              ↓
[退订检查] ←──────────────[准备发送]
        ↓
[幂等发送 + 重试] ──────→ [邮件 API]
                                       ↓
                              [Webhook 事件]
                                       ↓
              ┌────────┬────────┬─────────────┐
              ↓        ↓        ↓             ↓
         已送达   已退信   已投诉   已打开/已点击
                       ↓        ↓
              [更新退订列表]
                       ↓
              [列表维护任务]

快速参考

从这里开始

新应用？
从目录开始，规划应用所需的邮件类型（密码重置、验证等），然后在发送第一封邮件前设置好送达能力（DNS 认证）。

遇到垃圾邮件问题？
首先检查送达能力——认证问题是最常见的原因。Gmail/Yahoo 会拒收未经认证的邮件。

需要发送营销邮件？
遵循此路径：邮件捕获（获取同意）→ 合规性（法律要求）→ 营销邮件（最佳实践）。

需要生产级发送可靠性？
增强可靠性：发送可靠性（重试 + 幂等性）→ Webhook 与事件（跟踪送达）→ 列表管理（处理退信）。