phpmailer安装失败或发信异常的主因是php版本不匹配（需≥7.2，7.x需≥8.0）、mbstring/iconv扩展未启用、未引入autoload.php、命名空间错误、smtp用普通密码而非app password、邮件编码未统一设为utf-8且未调用ishtml(true)。

composer require phpmailer/phpmailer 装不上？先确认 PHP 版本和扩展

PHPMailer 6.x 要求 PHP ≥ 7.2，而 7.x（最新稳定版）已要求 PHP ≥ 8.0。如果 composer require phpmailer/phpmailer 报错“Your requirements could not be resolved”，大概率是 PHP 版本不匹配。

另外，mbstring 和 iconv 扩展必须启用——发中文邮件、处理编码时会直接报 Call to undefined function mb_convert_encoding() 这类错误，不是 Composer 安装失败，而是运行时报错。

• 检查 PHP 版本：php -v
• 检查扩展是否加载：php -m | grep -E 'mbstring|iconv'
• 若用 XAMPP/MAMP，需在 php.ini 中取消 ;extension=mbstring 和 ;extension=iconv 前的分号

require 后找不到类？别漏掉 autoload 和命名空间

装完后写代码提示 Class 'PHPMailer\PHPMailer\PHPMailer' not found，不是没装成功，是没引入自动加载或写错命名空间。

Composer 安装后不会自动 include，必须在脚本开头 require 'vendor/autoload.php';；同时 PHPMailer 使用完整命名空间，不能只写 new PHPMailer()。

• 必须包含自动加载：require 'vendor/autoload.php';
• 实例化要带完整命名空间：new PHPMailer\PHPMailer\PHPMailer(true)
• 如果用了 use，写法是：use PHPMailer\PHPMailer\PHPMailer; + new PHPMailer(true)
• 别把 vendor/ 目录删了，也别手动复制 src/ 文件进去——那样会绕过 autoloader，类照样找不到

SMTP 登录失败：Password 和 App Password 不是一回事

用 Gmail、Outlook 等第三方 SMTP 时，SMTPAuth = true 下填账号密码却报 Authentication failed，90% 是因为用了账户登录密码，而不是应用专用密码（App Password）。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

Gmail 已全面停用“允许不够安全的应用”选项，必须开两步验证 + 生成 App Password；Outlook 同理。普通密码在 SMTP 认证中会被拒绝，且错误信息往往只显示“authentication failed”，不提示原因。

• Gmail：进 Google 账户 → 安全 → 两步验证 → 应用专用密码（选“邮件”+“其他”，生成 16 位密码）
• Outlook：Microsoft 账户安全 → 高级安全选项 → 应用密码（生成后复制粘贴，别手敲）
• 代码里填的是这个 16 位字符串，不是你邮箱登录密码
• $mail->isSMTP(); $mail->Host = 'smtp.gmail.com'; $mail->Port = 587; $mail->SMTPSecure = 'tls'; 这几行缺一不可

发信内容乱码或收件箱显示为附件？编码和 Content-Type 得对上

中文主题/正文变成问号、方块，或者整封邮件被当附件下载（特别是 Outlook），通常是因为 CharSet、ContentType 和实际内容编码不一致，或没设 AltBody。

PHPMailer 默认用 utf-8，但如果你的 PHP 文件本身是 GBK 编码（比如老编辑器保存的），或没显式声明 $mail->CharSet = 'UTF-8'，就会出问题。HTML 邮件还必须配 $mail->isHTML(true)，否则 HTML 标签会被当纯文本转义。

• 强制设编码：$mail->CharSet = 'UTF-8';
• HTML 邮件必须加：$mail->isHTML(true);
• 避免 Outlook 当附件：提供纯文本备选内容，$mail->AltBody = '这是一封纯文本版本';
• 别用 echo 或 var_dump 测试发送逻辑——输出会污染邮件头，导致发送失败或格式错乱

真正麻烦的点不在安装，而在 SMTP 配置和编码链路的每一步都得咬死：PHP 版本 → 扩展 → Composer 加载 → 命名空间 → SMTP 凭据类型 → 邮件编码声明。漏一个，就卡在“明明装了却发不出”。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！