Class 'PHPMailer\PHPMailer\PHPMailer' not found 的根本原因是自动加载未生效或命名空间错误，需确认引入 vendor/autoload.php、使用完整命名空间 PHPMailer\PHPMailer\PHPMailer，并运行 composer dump-autoload -o 刷新自动加载。
composer install phpmailer 报错 Class 'PHPMailer\PHPMailer\PHPMailer' not found
这是最常见的问题：装了包但类找不到，根本原因是自动加载没生效或命名空间写错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认执行
composer require phpmailer/phpmailer后，vendor/autoload.php已在入口文件中引入（比如require 'vendor/autoload.php';） - 类名必须严格用
PHPMailer\PHPMailer\PHPMailer，不能漏掉中间的PHPMailer\—— 官方包的命名空间是两层PHPMailer\ - 如果用了 IDE 或静态分析工具，检查是否缓存了旧的 autoloader，可运行
composer dump-autoload -o强制刷新 - 别手动 require
src/PHPMailer.php这类文件，Composer 的 autoload 机制会按 PSR-4 自动定位，手写路径反而绕过自动加载
PHPMailer send() 返回 true 却没收到邮件
发送逻辑“成功”不等于邮件抵达收件箱，绝大多数情况是 SMTP 配置或服务商拦截导致的静默失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 开启调试模式：设置
$mail->SMTPDebug = 2（不是1），它会在控制台输出完整 SMTP 交互过程，能直接看到认证失败、被拒、5xx 响应等关键线索 - 检查
$mail->isSMTP()是否调用 —— 如果没开，send()会走系统 mail() 函数，而大多数 Linux 主机默认禁用或未配置 sendmail - Gmail / Outlook 等主流邮箱要求开启「应用专用密码」或允许「不够安全的应用」，且必须用 TLS/SSL 端口（Gmail 是
587+SMTPSecure = 'tls'，不是465） -
$mail->setFrom()的邮箱必须和 SMTP 登录账号一致，否则很多服务商直接拒信（例如用user@gmail.com登录，就不能设no-reply@example.com为发件人）
用 composer 加载 PHPMailer 后内存溢出或超时
这不是 PHPMailer 本身的问题，而是错误地把整个邮件对象反复 clone 或在循环里 new 太多次，尤其配合大附件或 HTML 模板时容易触发。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 每个邮件实例只用于发一封 —— 不要复用
$mail对象连续调用send()发多封，每次都要重新 new 或 reset（$mail->clearAddresses(); $mail->clearAttachments();） - 附件用
$mail->addAttachment($path)传绝对路径，别传 URL 或相对路径，否则可能触发 file_get_contents 全局读取失败再重试，拖慢并耗尽内存 - HTML 邮件内容避免内联大量 base64 图片，优先用
$mail->addStringAttachment()或外链（需配$mail->addEmbeddedImage()） - 如果批量发信，务必加
sleep(1)或队列控制频率，否则 Gmail 等服务端会限流，PHP 进程卡在 socket 等待，表现像超时
PHPMailer 中文收件人乱码或主题显示为编码字符串
本质是字符编码没对齐：PHP 脚本用 UTF-8，但 PHPMailer 默认按 ISO-8859-1 处理 header，导致中文被错误编码成 =?UTF-8?B?...?= 这种格式后又被二次转义。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确保脚本文件本身保存为 UTF-8 无 BOM 格式（编辑器可查），并在开头加
mb_internal_encoding('UTF-8'); - 不要手动调用
mb_encode_mimeheader()—— PHPMailer 内部已处理，只需保证$mail->CharSet = 'UTF-8';（注意是CharSet，不是charset） - 收件人姓名用
$mail->addAddress('to@example.com', '张三')，第二个参数直接传 UTF-8 字符串，不要自己 base64_encode - 主题乱码常见于用了
$mail->Subject = mb_convert_encoding(...)多余转换，删掉，只设$mail->Subject = '你好';即可
