应先验证依赖是否真无引用，再用composer remove卸载，接着删composer.lock并composer install同步vendor，最后composer dump-autoload -o重建加载并php think clear清框架缓存。
如果您在 ThinkPHP 项目中发现某些 Composer 包已不再被代码调用、配置注册或服务提供者引用，但依然保留在 vendor/ 目录和 composer.lock 中，则可能是由于依赖未被正确移除或存在残留声明。以下是清理 ThinkPHP 项目中 Composer 无效依赖的具体操作步骤：
一、确认目标依赖是否真正无用
Composer 本身不自动识别“无效依赖”，需结合 ThinkPHP 项目结构人工验证。无效依赖通常表现为：未在 app/、config/、route/ 或 provider/ 中被 use、new、ServiceProvider 注册、中间件引用或配置文件加载。
1、运行 composer show --tree 查看完整依赖树，定位目标包是否仅为某已卸载包的子依赖。
2、执行 composer depends vendor/package-name 检查是否有其他已安装包仍依赖它；若返回空行，说明该包当前无上游引用。
立即学习“PHP免费学习笔记（深入）”；
3、全局搜索项目根目录：grep -r 'PackageName' . --include="*.php" --include="*.yml" --include="*.yaml"（将 PackageName 替换为实际包名，如 topthink/think-queue）。
4、检查 config/app.php 中的 'providers' 和 'aliases' 数组，确认无对应服务提供者或类别名注册。
二、使用 composer remove 安全卸载
此方法适用于明确知道包名且其声明位于 composer.json 的 require 或 require-dev 区域的情况。ThinkPHP 项目中常见需清理的包包括废弃的扩展如 topthink/think-migration、topthink/think-captcha 等。
1、若包在 require 中（如生产环境扩展），运行：composer remove topthink/think-captcha。
2、若包仅用于开发（如 phpunit/phpunit 或 overtrue/laravel-wechat 的调试版本），加 --dev 参数：composer remove --dev phpunit/phpunit。
3、执行后验证：ls vendor/topthink/think-captcha 应提示 “No such file or directory”；composer show topthink/think-captcha 应报 “Package not found”。
三、强制同步 vendor 目录与锁文件
ThinkPHP 项目常因多次手动修改 composer.json 或跳过 composer install 导致 vendor/ 与 composer.lock 不一致，残留已删包的文件夹。此步骤确保物理目录与声明完全对齐。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
1、确认目标包已从 composer.json 的 require 和 require-dev 中彻底删除（可用 grep -n "package-name" composer.json 双重检查）。
2、删除 composer.lock 文件：rm composer.lock（仅限开发环境；生产环境应保留并使用 composer update --lock）。
3、执行 composer install --no-dev（ThinkPHP 生产部署推荐）或 composer install（含开发依赖），重建 vendor/ 目录。
四、重建自动加载并清除 ThinkPHP 缓存
ThinkPHP 依赖 Composer 自动生成的 autoload 映射，同时自身维护配置、路由、模板等缓存。卸载后若仍报 Class not found 或服务不可用，多因 autoload 未刷新或框架缓存未清。
1、强制重建 Composer 自动加载：composer dump-autoload -o。
2、清除 ThinkPHP 运行时缓存：php think clear（适用于 ThinkPHP 6+）。
3、若使用了 OPCache，需重启 Web 服务器或执行 opcache_reset()（如通过 CLI 脚本）。
五、使用 composer-unused 插件扫描隐式冗余
对于大型 ThinkPHP 项目，部分包可能仅通过字符串类名、注解（如 @throws）、事件监听器或中间件配置间接引用，常规搜索易遗漏。此插件可静态分析 src/ 和 app/ 下的 PHP 文件，识别未被直接 use 或 new 的声明包。
1、安装插件：composer require --dev composer-unused/composer-unused。
2、运行扫描：composer unused --no-interaction --exclude=tests,public,think（排除测试、静态资源及核心框架目录）。
3、对插件列出的候选包，逐个核查其是否在 app/middleware.php、app/event.php 或自定义命令类中被字符串形式加载。
