应使用 composer remove vendor/package-name 卸载包，它原子化执行删声明、删目录、更新 lock、重建 autoload；手动删 vendor 或改 composer.json 易致 autoload 错乱、类找不到、ci 构建失败。
直接执行 composer remove vendor/package-name 是唯一安全的删除方式，前提是 Composer ≥ 2.5 且包名完全匹配、显式声明、无强依赖冲突。其他操作——包括手动删 vendor/ 目录、硬改 composer.json 后跑 composer install——几乎必然导致 autoload 错乱、Class not found、CI 构建失败或锁文件哈希不一致。
确认包名和声明位置再执行 remove
命令失败最常见的原因是包名不准确或不在显式声明中：
-
composer show输出的name字段必须一字不差（比如monolog/monolog不是Monolog/Monolog） - 该包必须出现在
composer.json的require或require-dev中；如果只是被其他包带进来的（如psr/log），remove会直接报错Package ... is not required in your composer.json - 运行
composer show --tree vendor/package-name可快速定位它是否被某个 dev 工具间接引入，比如phpunit/phpunit→sebastian/exporter
remove 执行后 vendor 目录还在？这是正常但需补步
composer remove 默认不立即物理删除 vendor/ 下的目录，而是标记为待卸载，靠后续安装流程清理。这不是 bug，但容易误判为失败：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行
composer remove monolog/monolog后，ls vendor/monolog仍存在是预期行为 - 真正清空需补一步：
composer install（推荐）或composer update --lock && composer install - 跳过这步直接部署，
vendor/monolog会残留，且vendor/composer/autoload_classmap.php可能还存着旧类路径，导致静默加载失败
遇到 “Package is required by another package” 别硬删
这不是命令错误，是 Composer 的依赖保护机制在起作用。例如删 guzzlehttp/guzzle 被拒，大概率因为 symfony/http-client 明确 require 它：
- 先查谁在用：
composer why guzzlehttp/guzzle或composer depends guzzlehttp/guzzle - 若上游包也确实不需要，可一并删：
composer remove symfony/http-client guzzlehttp/guzzle（注意：不支持空格分隔多个包，必须逐个执行） - 慎用
--no-update绕过检查——它只改composer.json，后续composer update可能漏掉冲突解析，不推荐日常使用
删完必须人工扫三处硬编码残留
composer remove 只处理声明层和 autoload 映射，完全不管代码里的实际引用：
- 全局搜
use和new：grep -r "use GuzzleHttp\" . --include="*.php"（注意反斜杠转义） - 检查配置文件（如
config/logging.php）、服务提供者（app/Providers/）、事件监听器、注解（Doctrine / PHPStan）中是否还有硬编码调用 - 执行
composer dump-autoload -o（加-o是关键，尤其项目启用了"optimize-autoloader": true）
最容易被忽略的是 autoload classmap 缓存没刷新，以及配置文件里残留的实例化逻辑——这两处不清理，上线后 Class not found 报错几乎是确定的。
