CodeIgniter 3 的 Email 类是 Library 而非 Helper，需用 $this->load->library('email') 加载；SMTP 配置必须显式设置 protocol、host、port、user、pass、crypto；调试须用 print_debugger() 查具体错误；charset 必须小写 'utf-8'，HTML 邮件需设 mailtype='html' 并正确编码中文主题。
CodeIgniter 3 的 email 类不是 Helper，是 Library
很多人搜“Email Helper”却死活找不到 email_helper，因为 CodeIgniter 3 里发邮件用的是 Email 类（Library），不是 Helper。它默认不自动加载，也不能靠 load->helper('email') 启动——这么写会报错：Unable to load the requested helper: email_helper。
正确做法是加载 Library：
$this->load->library('email');
常见错误：在控制器里写 $this->load->helper('email')，结果调用 $this->email->from() 时提示 Call to a member function from() on null——根本没加载成功。
SMTP 配置必须显式设置，sendmail 或 mail() 在生产环境基本不可靠
本地开发用 mail 协议可能“看起来能发”，但一上服务器就失败：被当垃圾邮件、无发信记录、收件方直接进 spam。真实项目一律走 SMTP。
配置关键点：
-
protocol必须设为'smtp'（不能留空或写'mail'） -
smtp_host要写对，比如腾讯企业邮箱是'smtp.exmail.qq.com'，Gmail 是'smtp.gmail.com' -
smtp_port注意加密方式：TLS 用587，SSL 用465；填错端口会卡住或报Connection refused -
smtp_user和smtp_pass是账号密码，但 Gmail 等平台需用「应用专用密码」，不是登录密码 - 务必设
smtp_crypto，值为'tls'或'ssl'，漏掉会导致认证失败
示例片段：
$config = [
'protocol' => 'smtp',
'smtp_host' => 'smtp.exmail.qq.com',
'smtp_port' => 587,
'smtp_user' => 'notify@yourdomain.com',
'smtp_pass' => 'your_app_password',
'smtp_crypto' => 'tls',
'mailtype' => 'html',
'charset' => 'utf-8'
];
$this->load->library('email', $config);
$this->email->send() 返回 false 时，必须用 $this->email->print_debugger() 看具体哪步挂了
单纯判断 if (!$this->email->send()) 只知道失败，但不知道是 DNS 解析失败、认证被拒、还是内容被拦截。不查调试信息，等于蒙眼修 bug。
调试建议：
- 开发阶段加一句
echo $this->email->print_debugger(); die;，直接输出完整流程日志 - 重点关注三类错误：
Failed to connect to server（网络/端口问题）、Authentication failed（账号密码或权限不对）、Data not accepted（收件人格式错、主题为空、HTML 标签未闭合） - 如果调试器显示
Message body empty，检查是否漏了$this->email->message()或传了空字符串
中文乱码、附件打不开、HTML 邮件变源码 —— 全因 charset 和 mailtype 没对齐
三个参数必须同步设置：
-
charset设为'utf-8'（不是'UTF-8'大写，CI 对大小写敏感） -
mailtype设为'html'才支持 HTML 内容；设为'text'就纯文本，<br>
会被当字符显示 - 发送中文主题必须用
$this->email->subject(mb_encode_mimeheader('你好', 'UTF-8'))，否则 Outlook 等客户端显示问号 - 附件路径必须是服务器绝对路径（如
/var/www/html/uploads/file.pdf），相对路径会静默失败
一个典型坑：设了 mailtype => 'html'，但 message() 里传的是未转义的 PHP 变量（含换行或双引号），导致 HTML 解析出错，整封邮件变源码显示。
真正麻烦的从来不是配通 SMTP，而是某天服务商悄悄升级 TLS 版本、或某个中间件过滤了 User-Agent 头——这时候调试器里看不出异常，得抓包看实际 SMTP 交互。先确保基础链路稳了，再碰这些。
