Composer没有“关键帧清理”功能；所谓“关键帧丢失”实为误删vendor目录或composer.lock文件导致依赖环境崩溃，恢复方式为：有lock文件则运行composer install，无lock则需从Git历史或CI日志中找回。
Composer 本身不处理“关键帧”，也没有“关键帧清理”功能——这是常见误解。你遇到的大概率是误删了 vendor/ 目录、composer.lock 文件，或执行了 composer install --no-dev 后发现某些开发依赖（比如 PHPUnit、PHPStan）突然不可用，被当成“关键帧丢失”。
为什么删了 vendor 后“像丢了关键帧”？
-
vendor/是 Composer 下载并安装所有依赖包的实际目录，不是缓存，删了就真没了 -
composer.lock记录了每个包的确切版本、哈希值和依赖树；它一旦丢失或被覆盖，composer install就无法还原原始环境 - 某些工具（如 Laravel Mix、Vite 插件）在构建时会读取已安装的包内资源（例如
node_modules对应的 PHP 扩展配置），误删后表现为“功能断裂”，类似视频关键帧缺失导致解码失败
恢复核心逻辑很简单：有 composer.lock → 用 composer install；没 composer.lock → 只能靠 composer.json + 历史记忆/文档/提交记录尽量逼近
误删 vendor 后立刻能做的三件事
- 确认是否还在 Git 暂存区或未提交状态：
git status看vendor/是否列为 deleted，如果是，git checkout -- vendor/可秒恢复（前提是之前 commit 过） - 检查回收站 / Trash /
~/.local/share/Trash（Linux）或~/.Trash（macOS），部分文件管理器删除不会立即清空 - 运行
composer install前先执行ls -la确认当前目录下存在composer.lock；若不存在，别硬跑 install，否则会按composer.json中的约束重新解析版本，结果往往和原来不一致
注意：composer update 不是恢复操作，它是主动升级行为，会改写 composer.lock，进一步偏离原始状态
composer.lock 被删了怎么办？
- 查 Git 历史：
git log --oneline -- composer.lock，找到最近一次修改记录，然后git show <commit-hash>:composer.lock > composer.lock</commit-hash> - 如果项目用过 GitHub / GitLab CI，检查最近一次成功构建的日志，有时会打印出
composer install的完整输出，其中包含已安装包列表和版本号 - 若只有
composer.json，可尝试加--with-all-dependencies和锁版本约束（如"monolog/monolog": "2.9.1"）手动补全，但工作量大且易漏 —— 尤其当依赖链深（比如laravel/framework依赖symfony/*多个子包）时，版本错一个就可能引发冲突
真正麻烦的是：有些公司私有包未打 tag，只推了 dev-main，而该分支后来被 force push 覆盖过 —— 此时即使有 lock 文件，composer install 也可能拉不到原来的 commit
预防比恢复更重要
- 把
vendor/加入.gitignore是对的，但composer.lock必须提交，且每次composer require或update后都要git add composer.lock && git commit - CI 流程中不要用
composer install --no-interaction --prefer-dist就完事，建议加--dry-run阶段校验 lock 文件完整性，或用composer validate提前报错 - 本地开发机如果磁盘空间紧张，可用
composer archive打个 zip 备份当前vendor/（虽然不推荐长期依赖这个）
最常被忽略的一点：很多团队把 composer.lock 提交了，却忘了它默认不跟踪平台配置（如 PHP 版本、扩展）。一旦某台机器缺 ext-gd，哪怕 lock 文件完全一致，composer install 也会失败 —— 这不是恢复问题，而是环境契约没对齐
