手动上传扩展后 vendor 目录不识别，因 ThinkPHP 仅自动加载 Composer 安装的包；需确保 PSR-4 规范并配置 composer.json autoload 后执行 dump-autoload。
手动上传扩展后 vendor 目录不识别？
ThinkPHP 默认只自动加载 vendor 下由 Composer 安装的包，手动扔进去的文件不会被自动注册到类加载器里，哪怕路径完全正确也会报 Class not found。
必须补上两步：一是确保扩展有符合 PSR-4 规范的命名空间和目录结构；二是手动在 composer.json 的 "autoload" 段里加映射，再执行 composer dump-autoload。
- 常见错误现象：
Class xxx\yyy\Zzz not found，但文件明明在vendor/xxx/yyy/src/Zzz.php - 检查点：该扩展是否自带
composer.json？没有的话，你得自己写 autoload 配置 - 别直接改 ThinkPHP 核心的
Loader.php—— 升级时会被覆盖，且破坏可维护性
用 Composer 安装却提示 package not found
不是所有第三方扩展都发布在 Packagist 上，尤其是国内开发者写的 ThinkPHP 专用包，很多只托管在 Gitee 或私有 Git 仓库。
这时候得手动配置 Composer 的 repositories，告诉它去哪儿找。
立即学习“PHP免费学习笔记（深入）”；
- 使用场景：想装
topthink/think-swoole这类官方扩展没问题，但装xx/tp-wechat就可能失败 - 解决方法：在项目根目录的
composer.json里加一段"repositories"，类型设为vcs，URL 填对应 Git 地址 - 注意兼容性：
composer install会读取锁文件，如果之前没配仓库就跑过 install，得先删掉composer.lock再重装
vendor 里扩展能加载，但运行时报 Call to undefined method
这是典型的“类存在但方法不存在”，常见于扩展版本和 ThinkPHP 主版本不匹配。比如在 TP6.1 项目里装了只适配 TP8 的组件，或反过来。
尤其要注意扩展内部是否依赖特定的框架核心类（如 think\App、think\Request），这些类在不同大版本间有签名变化。
- 快速定位：看报错堆栈最上面那行调用来自哪个扩展文件，然后查它的
composer.json里"require": {"topthink/framework": "..."}字段 - 参数差异：TP6 的
Request::param()返回数组，TP8 改成默认返回对象，扩展若没适配就会崩 - 别硬改扩展源码来“兼容”——下次更新就丢，优先找对应版本分支或 fork 后打 patch
部署到生产环境时 Composer 自动安装失败
线上服务器往往没开 Composer，或者网络受限（比如不能访问 GitHub/GitLab），导致 composer install 卡住或报 Connection refused。
稳妥做法是本地完成安装并提交 vendor（虽然不推荐），或更优：用 composer install --no-dev --optimize-autoloader 打包好再上传，跳过线上拉包环节。
- 容易踩的坑：漏传
vendor/autoload.php，或上传时忽略了.gitignore里对vendor的排除规则，导致根本没传上去 - 性能影响：不加
--optimize-autoloader会导致每次请求都扫描整个vendor目录，慢一倍不止 - 如果你用的是宝塔或阿里云轻量应用服务器，记得确认 PHP CLI 版本和面板里选的运行版本一致，否则
composer装的扩展可能加载不了
