composer install报“No composer.lock file present”是明确拒绝执行，而非提示生成锁文件；必须用composer update解析composer.json生成lock，误删后重跑install无效。
composer install 报红字错误，先看是不是锁文件缺失
“No composer.lock file present”不是提示你“该生成一个”，而是直接拒绝执行。新版 Composer（v2.5+）会报 Command "install" is not defined，旧版可能静默失败，但 vendor/ 一定不完整或错乱。
这种情况根本不用纠结网络或镜像——composer install 的语义就是“按 lock 文件还原”。没有 lock，它连解析都不启动。
- 新项目第一次初始化，必须运行
composer update（不是 install），才会基于composer.json生成有效的composer.lock - 误删了
composer.lock，只跑composer install是无效的，只会反复报错 - 确认
composer.json中的require和require-dev是你当前想要的依赖状态——此时没 lock 兜底，任何拼写错误都会立刻暴露
报 Installation failed, reverting... 说明安装中途崩溃
这个错误意味着 Composer 已经开始写入 composer.json 和 composer.lock，但某一步失败后自动回滚。常见诱因不是代码写错，而是缓存损坏、镜像配置失效或 vendor 目录残留冲突。
- 先执行
composer clear-cache，Windows 用户还得手动删掉%LOCALAPPDATA%\Composer\cache - 删掉整个
vendor/目录和composer.lock文件（注意：不是只删 lock） - 再运行
composer install—— 它会重新生成 lock 并从头下载所有包 - 如果仍失败，加
--no-cache参数强制跳过本地缓存，避免复用损坏的 zip 包
镜像配置写了却没生效？检查全局配置是否真正写入
composer config -g repo.packagist 输出为空，说明配置压根没存成功，不是“没生效”，是根本没写进去。Composer 2.x 会静默 fallback 到官方源，不报错也不提醒。
- 正确命令必须带
-g、composer类型值、HTTPS 且结尾有/：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
repo.packagist必须是单数，写成repos.packagist或repositories.packagist.org都无效 - 项目根目录的
composer.json若含"repositories": []（哪怕空数组），也会完全屏蔽全局镜像；临时清掉用composer config --unset repositories - 验证真实请求地址：运行
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是实际走的源
想覆盖重装但不想删 vendor？用 --force-reinstall
删 vendor/ 太重，尤其 CI 环境里耗时长、易中断。composer install --force-reinstall 是专为这种场景设计的：不删 vendor、不改 lock，但强制重解压每个包、重建 autoload、重跑 post-install-cmd 脚本。
- 前提是
composer.lock已是最新的——如果composer.json改了但没同步 lock，先跑composer update --lock-only - Windows 下可能因文件被占用失败（如 PhpStorm 索引、Xdebug、Swoole 进程），需先关掉相关服务，或加
--prefer-dist减少符号链接依赖 - 不要用
composer update替代——它会改 lock、可能升版、跳过你想刷新的间接依赖
最常被忽略的是：重装后 vendor/bin/ 下的二进制路径可能变化，IDE 外部工具配置和 shell 的 $PATH 缓存得手动刷新；composer dump-autoload -o 也必须重跑，否则 autoload 仍指向旧文件。
