必须用composer require安装thinkphp扩展包，因install仅按lock文件复原依赖、忽略命令参数，update则可能误升核心框架；require会精准写入composer.json、下载至vendor并更新lock文件。
必须用 composer require 安装，其他方式基本无效或危险。 不是 composer install，也不是 composer update；漏掉这一步，扩展文件进不了 vendor/，类加载器根本看不到它。
为什么 composer install 装不上新扩展？
它只按 composer.lock 复原已有依赖，完全忽略你命令里写的包名。哪怕你输 composer install topthink/think-captcha，Composer 也会把 topthink/think-captcha 当作无意义参数丢弃。
- 现象：执行完没报错，但
vendor/topthink/think-captcha目录不存在，use thinkcaptchaCaptcha直接报错 - 验证方法：运行
ls -la | grep composer.json（Linux/macOS）或dir composer.json（Windows），确认当前路径下真有composer.json - 根本原因：你不在项目根目录（即含
composer.json和public/的目录），而是在public/或vendor/下误操作
安装后类还是找不到？检查服务提供者和配置文件
ThinkPHP 扩展不是“放进去就能用”，多数依赖服务提供者（Service Provider）注册，否则 Facade、配置、命令等全失效。
- 打开
config/app.php，检查'providers' => []数组是否已包含对应类，例如：thinkcaptchaCaptchaService::class - 检查
composer.json是否有"dont-discover": ["*"]—— 这行会全局禁用自动注册，删掉或改为具体值（如["laravel/framework"]） - 部分扩展（如
topthink/think-queue、topthink/think-filesystem）不会自动生成配置文件，需手动从vendor//config/复制到项目config/目录下
composer require 后还要注意版本和路径细节
指定版本不写对，很容易装错分支或漂移版本；入口文件少一行 require，整个 autoload 就断链。
- 安装指定版本必须用冒号语法：
composer require topthink/think-queue:3.0.12，等号=3.0.12在较新 Composer 版本中也支持，但@符号完全无效 - TP6/8 项目默认入口（
public/index.php）已含require __DIR__ . '/../vendor/autoload.php';，老项目或裁剪版务必手动补上，路径必须用__DIR__，别写死绝对路径 - 装完别在控制器或中间件里再
require vendor/autoload.php—— autoload 是全局单例，重复引入不报错但浪费，且可能干扰静态映射
最容易被忽略的是：扩展包的 autoload 配置是否真正生效，以及它声明的 PSR-4 前缀是否和你的 use 语句完全匹配。比如写 use appcommonHelper 却没在 composer.json 里配 "app\": "app/"，dump-autoload 也救不回来。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
