composer install本质是还原composer.lock中锁定的精确版本、哈希值和dist URL，不解析composer.json的版本约束；缺失或格式错误时会退化为update行为，导致逻辑错乱。
composer install不是“装依赖”，是还原锁文件
它不解析版本约束，只按composer.lock里记录的精确版本、哈希、dist URL去下载和解压。一旦composer.lock缺失或格式错误（比如混用 Composer 1.x 和 2.x），composer install就会 fallback 到 update 行为——这不是慢，是逻辑错乱。
常见误操作：
- 刚 clone 项目就跑
composer install却失败，先检查composer.lock是否在 Git 中已提交 - CI 脚本里漏写
--no-dev，结果把 PHPUnit 打进生产镜像 - 本地 PHP 版本低于
composer.lock中某包要求（如"php": ">=8.1"），却加--ignore-platform-reqs强行过，后续运行时直接报Class not found
Composer 2.x 的提速不是靠“更快下载”，而是跳过解析
Composer 2.x 在 install 阶段完全跳过依赖图构建——只要 composer.lock 没变，连 SAT 求解器都不启动。而 1.x 即使有 lock 文件，仍会做完整校验和路径推导。
这意味着：
-
composer install在 2.x 下耗时基本只取决于磁盘 IO 和解压速度，和包数量关系变小 - 升级到 2.x 后必须删掉旧
composer.lock再跑一次composer install，否则报Invalid lock file. Expected key "plugin-api-version" - 团队必须统一 Composer 版本；GitHub Actions 中要用
setup-php显式指定composer-version: '2.9.6'，不能依赖系统预装
--optimize-autoloader 和 --classmap-authoritative 别乱配
--optimize-autoloader（或 -o）把 PSR-4 映射转成 autoload_classmap.php，类加载从“遍历目录”变成“查表”，对 APCu 友好；但它会让 vendor/autoload.php 变大，首次 require 略慢。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
--classmap-authoritative（或 -a）更激进：它告诉自动加载器“不在 classmap 里的类，就不存在”，跳过所有 PSR-4 fallback。但若项目含运行时拼接类名（如 new $className()），会直接报错。
安全组合：
- 生产环境用
composer install --no-dev -o，足够稳 - 确认无动态类加载后，再加
-a；开发环境永远不要加-a -
"apcu-autoloader": true可替代-a，APCu 缓存 classmap 查询结果，不破坏兼容性
真正卡住你的往往不是网络，是 autoload 和 lock 文件
实测显示，大型项目中 composer install 70% 耗时花在 autoload 文件生成和 composer.lock 解析上，而非下载。一个 12MB 的 lock 文件（含大量私有包和未清理的 require-dev）会让 JSON 解析吃满 CPU。
可立即见效的操作：
- 运行
composer update --lock压缩 lock 文件结构，删冗余字段 - 删掉
composer.json里长期不用的 dev 工具，如旧版phpstan/phpstan - 私有包声明中加
"archive": {"exclude": ["/tests", "/docs"]}，避免这些路径被计入 hash - CI 中加
--no-interaction --no-progress，省掉 ANSI 控制符输出和交互等待
别迷信“换镜像=变快”。国内镜像只解决下载瓶颈；当 lock 文件膨胀、autoload 未优化、PHP 版本不匹配时，换源毫无意义。
