composer怎么查看包的磁盘占用_composer查看依赖体积大小方法

2次阅读

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

composer怎么查看包的磁盘占用_composer查看依赖体积大小方法

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
  • 文档生成工具链(phpdocumentorroave/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/*)。

text=ZqhQzanResources