Composer本身不支持限制单个包下载大小，所谓“限制”实为通过cache-files-maxsize控制缓存总容量、--prefer-dist和--no-dev避免大体积源码与dev依赖、镜像源加速及版本锁定等间接手段实现。
Composer 本身不支持限制单个包下载大小
别被“限制下载大小”误导——Composer 没有 max-download-size 或类似配置项。它不会在 ZIP/TAR 流下载过程中检查文件体积并中断。所谓“限制下载大小”，实际是通过控制缓存行为、跳过非必要内容、或提前规避大包来间接实现的。
用 cache-files-maxsize 控制缓存总盘空间
这是唯一真正作用于“大小”的 Composer 原生命令，但它管的是本地缓存目录总容量，不是单次下载或某个包的体积：
-
composer config -g cache-files-maxsize 536870912（设为 512MB） -
composer config cache-files-maxsize 1073741824（仅当前项目，1GB） - 该值单位是字节，只在写入新缓存前检查
cache-dir下所有文件总大小，超限则自动清理最旧缓存 - 不影响下载过程本身：一个 200MB 的私有 dist 包仍会完整下载并缓存，只是下次缓存满时可能被踢掉
- 和
cache-dir、cache-max-age完全独立，三者互不干扰
靠 --prefer-dist + --no-dev 砍掉大部分体积来源
真正让“下载变小”的不是限速或截断，而是避免拉取那些天生就大的东西：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--prefer-dist强制走 ZIP 包而非git clone：多数包的 dist ZIP 比完整 Git 历史小 3–10 倍 -
--no-dev跳过require-dev中的所有包：像phpunit/phpunit、symfony/var-dumper这类工具包常占下载总量 40% 以上 - 二者组合效果显著：
composer install --no-dev --prefer-dist在 CI 中应为默认写法 - 注意：
--prefer-dist不影响http.max-parallel，并发下载数仍由该参数控制
镜像源 + 私有仓库白名单才是治本之策
很多“大下载”其实来自慢速或不可信源的重复拉取，或者误引入了未压缩的开发版包：
- 切阿里云/腾讯云镜像源后，相同包平均下载耗时降 60%，失败重试减少，间接降低无效下载量
- 在
composer.json中显式锁定稳定版本，避免"dev-master"或"*@dev"：后者可能触发下载带完整测试资源的开发快照 - 私有仓库若允许上传未压缩的源码包（如含
tests/、docs/、.github/），应在服务端配置 dist 生成策略，而非靠客户端“限制” -
COMPOSER_HTTP_MAX_PARALLEL=1能缓解弱网超时，但不会让包变小；它只是把大包拆成更慢的单线程下载
最容易被忽略的一点：cache-files-maxsize 不会阻止首次下载大包，它只管后续缓存腾挪。真要精简下载，得从依赖声明源头卡住——删掉不用的 dev 包、禁用 dev 分支、换镜像、关 xdebug，比任何“限制”都直接有效。
