Composer 无内置命令显示包体积,需用系统工具分析:Linux/macOS用du -sh vendor/* | sort -hr | head -20,Windows用PowerShell脚本;注意符号链接、dev包、重复版本及.git目录等干扰项。

composer list 能看到包但看不到体积
执行 composer list 或 composer show 只显示包名、版本、描述,不提供磁盘占用信息。Composer 本身没有内置命令统计 vendor/ 下各包体积,必须借助系统工具或脚本辅助分析。
Linux/macOS 下用 du 快速定位大包
进入项目根目录后,直接用 du 按大小排序查看 vendor/ 子目录:
du -sh vendor/* | sort -hr | head -20
说明:
-
-s表示汇总每个目录总大小,-h以人类可读格式(KB/MB/GB)显示 -
sort -hr按数值逆序排列(最大在前),head -20只看前 20 名 - 注意:某些包会 symlink 到全局 Composer cache(如启用了
cache-dir),实际磁盘占用可能比vendor/显示的小 - 若发现
vendor/composer目录异常大,通常是 autoloader 生成的autoload_classmap.php或installed.json过大,一般无需干预
Windows 用户可用 PowerShell 替代方案
PowerShell 中无法直接用 du,但可用以下命令等效替代:
Get-ChildItem vendor | ForEach-Object { [PSCustomObject]@{Name=$_.Name; Size=(Get-ChildItem $_.FullName -Recurse | Measure-Object -Property Length -Sum).Sum} } | Sort-Object Size -Descending | Select-Object -First 20 Name, @{Name="SizeMB";Expression={[math]::Round($_.Size / 1MB, 2)}} 常见问题:
- 执行慢:因递归遍历所有文件,尤其当
vendor/含大量小文件(如测试用例、文档)时明显卡顿 - 符号链接未展开:PowerShell 默认不跟随 symlink,若 Composer cache 被复用,结果会低估真实占用
- 权限报错:跳过无访问权限的子目录,建议以管理员身份运行或加
-ErrorAction SilentlyContinue
排除干扰项:缓存、dev-only 包与重复安装
以下情况会导致体积统计失真,需手动识别:
-
vendor/bin/下的二进制工具(如phpunit、phpcs)通常只是软链,不占额外空间;但某些包(如laravel/installer)会把完整 PHAR 复制进来 -
require-dev中的包(如phpunit/phpunit)在生产环境不应存在,若误部署,du结果会包含它们 - 同一包多个版本共存:比如
vendor/myorg/sdk和vendor/myorg/sdk-backup,Composer 不自动清理重命名残留 - Git 相关元数据:
vendor/some/package/.git/若存在(常见于path类型仓库或开发中手动 clone),会显著增大体积,应删掉
真正影响部署包大小的关键,往往不是最热门的包,而是被间接依赖带入的、含大量资源文件(如 symfony/translation 的 Resources/translations/)或文档(如 doctrine/orm 的 docs/)的包——这些不会出现在 composer.json 中,却实实在在吃掉磁盘。










