ThinkPHP 5.1 引入第三方类库必须通过 Composer 安装并正确配置命名空间与自动加载，手动复制文件无效；需严格匹配包的 namespace、use 语句及文件名大小写，非 PSR-4 规范包须手动添加 classmap 并执行 dump-autoload。
ThinkPHP 5.1 引入第三方类库不是“放进去就能用”，而是容易卡在命名空间、自动加载、Composer 配置三个关键环节。官方移除了 import() 和 Vendor() 等旧方法，强行沿用只会报错找不到类——问题不在代码写错，而在加载机制已彻底重构。
必须走 Composer 安装，手动放 vendor 不生效
TP5.1 废弃了通过 vendor/ 目录直接 require 或 import 的方式。哪怕你把 PHPExcel 文件夹完整拖进 vendor/phpoffice/phpexcel，不执行 Composer 安装，框架就无法识别它。
- 正确做法：运行
composer require phpoffice/phpexcel（注意：该包已归档，推荐改用phpspreadsheet） - 安装后检查
composer.json中是否新增对应条目，如"phpoffice/phpspreadsheet": "^1.24" - 执行
composer dump-autoload确保 PSR-4 映射写入vendor/composer/autoload_psr4.php
命名空间和 use 必须严格匹配包的结构
很多失败源于只写了 use，却没看清第三方包自身声明的 namespace。例如 phpspreadsheet 的读取器路径是 PhpOffice\PhpSpreadsheet\Reader\Xlsx，不是 PHPExcel\Reader\Xlsx。
- 打开第三方包源码第一行，确认其
namespace（比如namespace PhpOffice\PhpSpreadsheet;） - 控制器中
use必须完整写对：use PhpOffice\PhpSpreadsheet\Reader\Xlsx; - 实例化时不用再加前缀：
$reader = new Xlsx();，不是new PhpSpreadsheet\Reader\Xlsx()
非标准结构包需手动注册自动加载
有些老包（如自定义的 gmars/tp RBAC 类）未遵循 PSR-4 规范，Composer 默认不会加载。此时不能靠 use，得显式配置。
立即学习“PHP免费学习笔记（深入）”；
- 在
composer.json的"autoload"节下添加 classmap："autoload": { "classmap": ["vendor/gmars/tp/src/"] } - 运行
composer dump-autoload刷新映射 - 之后可直接
use gmars\rbac\Rbac;，无需require_once
别忽略大小写和文件名一致性
开发时在 Windows 上可能正常，一上 Linux 服务器就报 Class not found——因为类文件名 BirdExpress.php 对应的类名必须是 BirdExpress，且命名空间路径中 controller 全小写，不能写成 Controller。
- 检查文件名与类名是否完全一致（包括大小写）
- 确认
use语句中的路径层级和大小写，与文件系统真实路径逐级对应 - Linux 下临时测试可用
ls -l app/controller/查看实际命名
