Composer安装PHPMailer后报Class not found，90%因未引入autoload、命名空间错误或SMTP配置顺序不当：须在脚本开头require 'vendor/autoload.php'，用全限定名new PHPMailer\PHPMailer\PHPMailer()，且isSMTP()必须在setFrom()前调用。
直接运行 composer require phpmailer/phpmailer 就行，但装完发不出邮件、类找不到、报错 Class 'PHPMailer\PHPMailer\PHPMailer' not found——这些问题 90% 不是命令写错了，而是后续三步没做对：autoload 没引入、命名空间写漏、SMTP 配置顺序错了。
composer require phpmailer/phpmailer 装不上？先查这三件事
装不成功，大概率卡在环境或配置环节，不是包名问题：
- 确认当前目录下有
composer.json（ls -l composer.json），且没被composer.lock锁死旧版本（可临时删掉再试） - 运行
php -v看 PHP 版本：v6.x 要求 ≥ 7.2，v7.x 要求 ≥ 8.0；若用 PHP 5.x 或 7.1，只能退到phpmailer/phpmailer:5.2.28（已停止维护，不推荐） - 国内网络偶尔会卡在源上，可临时切官方源：
composer config -g repos.packagist.org '{"type": "composer", "url": "https://packagist.org"}'
装完了却 new PHPMailer() 报 Class not found？autoload 路径和命名空间必须严丝合缝
Composer 安装成功 ≠ 类能自动用。PHP 不会自己加载 vendor 里的类，你得亲手拉它一把：
- 入口脚本开头必须加：
require 'vendor/autoload.php';（路径要对：如果脚本不在项目根目录，用require __DIR__ . '/vendor/autoload.php';） - 类名必须写全：
new PHPMailer\PHPMailer\PHPMailer(true)，不能只写new PHPMailer() - 如果用了
use，必须两行都写：use PHPMailer\PHPMailer\PHPMailer;+use PHPMailer\PHPMailer\SMTP;（v6+ 强制双层命名空间PHPMailer\PHPMailer\，漏掉中间那个PHPMailer\就报错） - 别手动
require任何src/下的文件——那会绕过 Composer 的 PSR-4 自动加载，类照样找不到
SMTP 配置失败：isSMTP() 必须在 setFrom() 之前，且 Password 不是登录密码
大多数“发不出去”根本不是安装问题，而是 SMTP 链路断在第一步：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
-
$mail->isSMTP()必须在$mail->setFrom()之前调用，否则静默退化成mail()函数（本地基本不可用） -
$mail->Password填的是「应用专用密码」，不是邮箱登录密码：Gmail 要开两步验证后生成 16 位 App Password；QQ 邮箱要在账户设置里开启 SMTP 并获取授权码 - 端口和加密方式必须匹配：
SMTPSecure = 'tls'对应端口 587，SMTPSecure = 'ssl'对应端口 465；填反了会卡在连接阶段，报SMTP Error: Could not authenticate - PHP 8.1+ 下
setFrom('a@example.com', '张三')会触发Deprecated: strlen(): Passing null to parameter #1，必须显式传第三个参数：setFrom('a@example.com', '张三', true)
本地能发、上线就失败？先 telnet 测端口通不通
宝塔、cPanel、轻量云服务器常默认封 SMTP 出站端口（25/465/587），不是代码问题：
- 连不上 smtp.qq.com 的 587 端口，
$mail->send()就必然超时或报connect() timeout - 用
nc -zv smtp.qq.com 587或telnet smtp.qq.com 587测试连通性，不通就不用往下调了 - 腾讯企业邮箱等还可能需要在后台管理界面手动开启「SMTP 外发权限」，光配 PHPMailer 没用
- 调试必开：
$mail->SMTPDebug = 2;，否则错误信息全是黑盒，看不出卡在哪一步
最常被跳过的其实是第一句 require 'vendor/autoload.php';——它看起来最简单，一旦路径错、位置错、漏掉，后面所有操作都在空中楼阁里跑。
