要查 composer 包体积,需用插件或系统命令:官方 composer show -i 不支持体积统计;推荐 baethon/composer-packages-size 插件,或 linux/macos 用 du -sh vendor/* | sort -hr | head -20,windows 用 powershell 对应命令。

composer show -i 查不出包体积,得换命令
默认 composer show -i 只列已安装包和版本,不带大小信息。想看磁盘占用,必须借助插件或手动统计——官方原生命令不支持体积维度。
-
composer global require baethon/composer-packages-size是目前最轻量、兼容性最好的方案(支持 Composer 2.x) - 装完直接运行
composer packages-size,它会扫描vendor/下每个包的文件总大小,并按降序排列 - 注意:该插件统计的是解压后实际占用空间,不是
.zip或.tar.gz下载体积
不用插件时,用 du 手动查 vendor 子目录
Linux/macOS 用户可绕过插件,用系统命令快速定位“吃磁盘”的包。关键不是看单个文件,而是统计整个包目录:
- 进项目根目录后执行:
du -sh vendor/* | sort -hr | head -20 - 这行命令能列出前 20 大的 vendor 子目录,
du -sh统计的是实际磁盘占用(含嵌套子目录) - Windows 用户可用
Get-ChildItem vendor -Directory | ForEach-Object { [PSCustomObject]@{Name=$_.Name;Size=(Get-ChildItem $_.FullName -Recurse | Measure-Object Length -Sum).Sum} } | Sort-Object Size -Descending | Select-Object -First 20 - 注意:
vendor/composer/installed.json里的包名和vendor/下目录名可能不一致(比如带 vendor 前缀),别靠名字硬猜
为什么有些包体积特别大?常见原因
看到某个包占几百 MB,大概率不是代码本身大,而是混进了不该在生产环境存在的东西:
- 测试用例、fixtures、demo 页面被打包进
dist/或examples/目录(如symfony/symfony的完整源码包) - PHP 扩展的二进制预编译文件(如
ext-protobuf相关包附带的.so或.dll) - 文档生成工具链(
phpdocumentor、roave/better-reflection等)把大量缓存或 AST 数据写进vendor/子目录 - 包作者没设
"files": []或"autoload-dev"隔离,导致tests/、docs/被一并安装
清理体积要小心 autoload 和 require-dev 的影响
删 vendor 子目录看似直接,但容易破坏依赖关系或自动加载:
- 不要手动删
vendor/autoload.php或修改其内容,否则class not found错误会立刻出现 - 如果确认某包只用于开发(如
phpunit/phpunit),应确保它只在require-dev里,且没被require间接拉入 - 删完某个大包后,务必运行
composer dump-autoload,否则 autoloader 缓存仍指向已删除路径 - 某些包(如
laravel/framework)体积大但不可删——它被框架核心强依赖,删了项目直接起不来
实际查体积时,最容易忽略的是软链接和重复文件:同一份源码可能被多个包 symlink 引用,du 默认按硬链接计数,而插件统计的是逻辑大小。真要抠细节,得加 -L 参数(du -shL vendor/*)。










