需通过Composer安装phpmailer/phpmailer包、引入vendor/autoload.php、正确使用PHPMailer\PHPMailer命名空间、执行composer dump-autoload -o刷新加载，并验证类存在性。
如果您在ThinkPHP项目中需要实现邮件发送功能，但PHPMailer类无法加载或发送失败，则可能是由于安装路径错误、自动加载未引入或包名不正确导致。以下是解决此问题的步骤：
一、通过Composer安装PHPMailer主包
Composer是ThinkPHP项目中推荐且最可靠的安装方式，必须使用官方迁移后的包名，避免因大小写或旧包名引发Class not found错误。
1、确保已进入ThinkPHP项目根目录（即包含composer.json和vendor文件夹的目录）。
2、执行命令：composer require phpmailer/phpmailer。
立即学习“PHP免费学习笔记（深入）”；
3、确认执行后vendor/autoload.php文件存在，且vendor/phpmailer/phpmailer目录下包含src/子目录及全部PHP类文件。
4、检查composer.json中是否新增了"phpmailer/phpmailer": "^6.9"（或对应版本）依赖项。
二、手动引入Composer自动加载器
ThinkPHP不会自动加载第三方库，必须在调用PHPMailer前显式引入Composer的自动加载机制，否则PHPMailer\PHPMailer\PHPMailer类将无法解析。
1、在邮件发送逻辑所在文件（如控制器方法或封装类）的最顶部添加：require __DIR__ . '/../vendor/autoload.php';（路径需根据当前文件位置调整）。
2、若在ThinkPHP应用入口文件（如public/index.php）中引入，应使用绝对路径：require dirname(__DIR__) . '/vendor/autoload.php';。
3、验证引入是否生效：在引入后添加var_dump(class_exists('PHPMailer\PHPMailer\PHPMailer'));，返回true表示成功。
三、修正命名空间与类引用方式
PHPMailer官方包的完整命名空间为PHPMailer\PHPMailer，两层结构不可省略或错写，否则会导致类找不到。
1、在代码开头正确声明命名空间别名：use PHPMailer\PHPMailer\PHPMailer;。
2、实例化时必须使用完整限定名或已声明的别名：$mail = new PHPMailer(true);。
3、禁止使用new \PHPMailer();、new phpmailer\phpmailer\phpmailer();或new PHPMailer\PHPMailer();（缺少末级类名）等错误写法。
四、刷新Composer自动加载映射
当出现Class 'PHPMailer\PHPMailer\PHPMailer' not found但包已安装时，常因自动加载映射未更新所致，需强制重建PSR-4映射表。
1、在项目根目录下运行：composer dump-autoload -o。
2、确认输出中包含Generated optimized autoload files提示。
3、若使用IDE（如PhpStorm），清除其缓存并重新索引项目，避免静态分析误报。
五、验证安装结果并排除常见误操作
安装完成后需立即验证基础可用性，同时排查高频人为失误点，确保环境纯净可靠。
1、创建最小可测脚本（如test-mail.php），仅包含引入、实例化和echo 'OK';，确认无Fatal Error。
2、检查是否手误执行了composer require PHPMailer/PHPMailer（大小写错误，触发404）。
3、确认未添加--dev参数，否则生产环境部署时未执行composer install将缺失该包。
4、严禁手动require源码文件（如src/PHPMailer.php），此举绕过Composer自动加载，必然失败。
