Composer如何移除依赖包 Composer项目瘦身操作指南
移除Composer依赖包需谨慎操作，避免残留隐患。推荐使用`composerremove`命令，可自动清理配置与文件。若手动编辑composer.json，必须随后运行`composerinstall`以清除残留。移除后需全局检查代码、配置及测试中是否仍存在对该包的引用，确保无隐性依赖，实现真正项目瘦身。
给项目“瘦身”，移除不再需要的Composer依赖包，听起来是个简单的操作，但实际操作起来，稍有不慎就可能留下隐患。直接删除composer.json里的包名，远不等于安全卸载。真正的“瘦身”，意味着代码库和配置中不再有任何对该包的隐性依赖。
这里有个核心原则需要牢记：直接移除依赖包，并不会自动清理autoload配置和残留文件。你必须手动验证vendor/autoload.php是否仍能正常加载，以及代码中是否还存在未声明的类引用。
运行 composer remove 命令（推荐方式）
最稳妥、最推荐的方法是使用Composer 2.2及以上版本内置的remove命令。这个命令是个“一站式”解决方案，它会帮你完成三件事：从composer.json中删除对应条目、执行composer install来清理vendor/目录，并同步更新PSR-4等autoload相关配置。
- 执行命令很简单：
composer remove monolog/monolog。这比手动编辑composer.json后再执行composer install更安全，也更能保证依赖树的完整性。 - 如果执行时提示
Package “xxx” is not required in your composer.json，别慌。这通常意味着你要移除的包是一个“间接依赖”（transitive dependency），即它是你声明的某个其他依赖包所引入的。这时，你需要先用composer show -t命令查看依赖树，定位是哪个上游包引入了它，然后考虑是否移除或更换那个上游包。 - 命令执行完毕后，别忘了检查一下
composer.json文件，确认require或require-dev区域里对应的包名确实已经消失了。
手动编辑 composer.json 后必须运行 composer install
如果你习惯手动编辑composer.json文件来删除包名，那么后续操作至关重要。仅仅删除文件里的条目，Composer并不会主动去清理vendor/目录下已经安装但不再声明的包。这些残留文件就像“幽灵依赖”，可能在未来引发自动加载冲突，或者被某些代码误用。
- 编辑完
composer.json后，务必立即运行composer install --no-dev（生产环境）或composer install（开发环境）。这个命令会强制Composer根据新的依赖声明重新安装和整理vendor/目录，从而移除无用的包。 - 如果你的项目启用了autoloader优化（例如在部署时使用了
--optimize-autoloader选项），那么在删包后，记得重新生成优化后的autoloader：composer dump-autoload -o。 - 这里有个常见的误区：不要用
composer update来代替composer install。update命令的主要目的是升级包版本，它会尝试更新所有依赖，这完全偏离了“瘦身”的本意，除非你确实需要同步更新其他包。
检查残留类引用和自动加载问题
包从vendor/里移除了，但麻烦可能才刚刚开始。最常见的错误就是页面突然抛出Class ‘MonologLogger’ not found这类致命错误。这说明你的业务代码、配置文件或测试文件中，仍然存在对该包的硬编码调用。
- 第一步，进行全局搜索。使用IDE的全局搜索功能，查找类似
use Monolog、new Logger、Monolog\这样的关键词（注意命名空间分隔符的转义）。 - 第二步，检查框架配置。重点查看
config/目录下的配置文件、app/Providers/目录下的服务提供者，以及tests/测试目录。这些地方经常注册了包的服务提供者、门面（Facade）或别名，移除包后必须同步清理。 - 第三步，验证autoload映射。运行
composer dump-autoload -p（-p选项代表仅处理PSR-0/PSR-4映射），可以快速检查autoload配置是否干净。如果失败，通常意味着有未清理的映射项。 - 特别留意测试依赖。有些包，比如
phpunit/phpunit本身是通过require-dev引入的，但你的测试用例里可能使用了类似@requires extension mbstring这样的注解。移除开发依赖后，这些测试可能无法运行，需要你删除或重写相关的测试逻辑。
说到底，一个真正“瘦下来”的项目，不仅仅是vendor/目录体积减少了几兆字节。它的标志是所有代码路径——包括那些不常走的——都不再隐式依赖那个已被移除的包。最容易被忽略的“死角”往往是配置文件里以字符串形式存在的类名、事件监听器数组、中间件注册列表。这些地方不会立即报错，但会在某个不经意的请求触发时，导致系统崩溃。因此，彻底检查是确保项目健康的关键一步。
PHP开发中，定位类文件不应依赖composerdump-autoload（仅重新生成映射文件，不会自动发现新类）。有效方法：使用composershow--path查包路径并结合PSR-4规则定位；或使用ripgrep搜索类定义；IDE跳转需确保索引正确，来避免误定位。并且避免直接修改vendor目录。
composershow列出所有包及版本（含开发依赖），--direct查看顶层依赖，--name-only输出纯包名，--format=json输出JSON。composeroutdated检查可更新包，composershow-t显示依赖树层级。版本号基于composer.lock，不保证vendor真实状态，需先运行composerinstall（或-
使用composerclear-cache命令可以安全地清除缓存，仅清理缓存目录下的内容。安装新版本需要先删除composer.lock后执行install或update，CI/CD中务必加--no-interaction参数。在缓存目录下files/可以删除旧包以释放空间，vcs/可以安全清除，repo/不建议删除该目录以免影响依赖解析。
Composer的稳定性配置中，minimum-stability是硬性过滤闸，低于该级别的版本被直接忽略；require里加@后缀可精准授权单个包；prefer-stable仅在候选版本中影响选择；子依赖的minimum-stability可能覆盖项目设置，需用stability-flags压制，以此确保依赖版本符合预期。
Composer不安装PHP扩展，仅当执行install或update时，会检查ext-xxx是否启用，若缺失则中断并报错。扩展声明须在require或require-dev中，版本号仅用于约束，无实际校验作用。扩展名必须与php-m输出的模块名完全一致。config.platform仅模拟环境，不能绕过运行时校验。
使用Phinx时需要手动配置phinx.php或phinx.yml文件并补全数据库连接信息；迁移文件须手写up和down方法，并仔细检查字段类型及索引细节；多环境切换时必须严格确认配置优先级和命名格式，否则极易导致迁移失败甚至报错。
使用replace时需注意：它仅仅声明替代关系，不会自动删除旧包，也不会继承旧包的autoload配置。因此，开发者必须手动移除旧包，并完整配置autoload，同时添加conflict字段来避免依赖冲突。另外，replace适用于替换具体包，而实现接口则应使用provide。
Composer是Yii根基，需正确配置composer.json区分require与require-dev，准确设置入口文件autoload.php路径，用create-project安装而非直接require核心库，锁死版本约束防兼容问题，并注意cookieValidationKey等环境配置。
Postman是一套面向API全生命周期的开发与测试平台，可在Mac上发送和调试多种协议请求，管理集合、环境及认证信息，并完成脚本测试、模拟服务、监控、文档发布和团队协作。它适合开发、测试及运维人员使用，提供个人免费方案。
Docker Desktop 是 Docker 官方为 Mac 提供的容器开发环境，集成 Docker Engine、命令行工具、Compose、Build、Kubernetes 与图形化管理界面。
Android Studio 是 Google 面向安卓应用开发提供的官方集成开发环境，基于 IntelliJ IDEA 构建。它整合智能代码编辑、Gradle 构建、界面预览、设备模拟、性能分析、调试测试及 APK 分析等工具。
PixPix 是面向品牌、卖家和内容团队的在线 AI 图片视频创作平台，提供图视频 Agent、无限画布、图片生成、视频生成、自然语言编辑及商品套图、产品精修和带货视频等电商工具。
Postman 是面向 API 全生命周期的开发与协作平台。Windows 桌面版可用于构建和发送 HTTP、GraphQL、gRPC、WebSocket、MQTT 等请求，并提供环境变量、集合、脚本测试、模拟服务、监控、文档及团队工作区等
Docker Desktop 为 Windows 开发者提供集成式容器环境，内置 Docker Engine、命令行工具、Compose、Build 与 Kubernetes 等组件，可在本机完成镜像构建、容器运行、日志查看和资源管理。