先运行composer validate：若报“the lock file is not up to date”，属过期，执行composer update --lock；若报“./composer.lock is invalid”并带json行号错误，才是真损坏，需备份后重建。
composer.lock 损坏不是断网直接造成的，而是断网后你手动干预或 Git 合并出错导致的；真损坏必须用 composer validate 确认，别猜。
怎么判断是“真损坏”还是“只是过期”
断网中断 composer install 或 composer update 后，常见现象是 lock 文件残留半截 JSON、换行符错乱、或字段缺失。但这些不一定等于“损坏”——90% 实际是“过期”：
-
composer validate报The lock file is not up to date with the latest changes in composer.json→ 过期，composer.json被改过但没同步 lock，执行composer update --lock即可 -
composer validate报./composer.lock is invalid并带具体 JSON 行号（如Parse error on line 123）→ 真损坏，可能是编辑器乱码保存、Git 合并冲突残留（比如还在文件里） - 不报错但
composer install卡在 autoload 加载或提示Invalid lock file. Corrupted.→ 多半是 dist.sha256 校验失败，说明 lock 记录的哈希和实际包不匹配，通常因断网后手动删了 vendor 又没清缓存
断网中断后 vendor 和 lock 都不完整，怎么安全重建
别直接删 lock 再 composer install——v2.5+ 会直接报 Command "install" is not defined。正确路径取决于 vendor 是否可信：
- 如果
vendor/目录存在且没动过（比如只是网络断了但解压已完成），先备份：cp composer.lock composer.lock.bak，再运行composer update --lock。它只重写 lock，不碰 vendor，输出应为Lock file operations: 0 installs, 0 updates, 0 removals - 如果
vendor/已被删或不确定是否完整（比如断网时正在写入），先rm -rf vendor composer.lock，再composer install --no-cache。加--no-cache是防止 Composer 从损坏的本地缓存里恢复旧包 - 千万别用
composer update替代——它会查远程最新版，可能升级一堆包，彻底偏离原依赖状态
Git 合并冲突导致 lock 文件“假损坏”，怎么识别和清理
Windows 和 Linux 协作者共用一个项目时，composer.lock 经常被 Git 标为 modified，但内容看起来正常。这时不能靠肉眼判断：
- 先跑
composer validate：通过 → 不是损坏，只是换行符或空格差异；失败 → 真有冲突残留 - 用
git status看是否显示both modified，再cat composer.lock | head -n 5查看开头是否有或乱码行 - 确认是 Git 冲突后，不要手动删冲突标记：用
git checkout --ours composer.lock或git checkout --theirs composer.lock选一边，再立刻composer validate验证 - 若选完仍报错，说明冲突已破坏结构，此时应放弃当前 lock，从上一个 clean commit 恢复：
git checkout HEAD~1 -- composer.lock
重新生成 lock 后为什么 vendor/autoload.php 还是加载失败
这往往不是 lock 问题，而是路径或权限链断裂：
- 确认当前工作目录是项目根目录（含
composer.json的那层），否则require 'vendor/autoload.php'会按相对路径找，自然失败 - 检查
vendor/autoload.php文件是否存在且非空：ls -l vendor/autoload.php，若大小为 0，说明安装中途退出，需重装 - 某些 IDE 或 Docker 环境会挂载 vendor 到只读层，导致自动加载脚本无法写入或执行，报
Permission denied；此时要检查容器启动参数或 IDE 设置 - 如果
vendor/composer/autoload_static.php里 classmap 路径写死为绝对路径（少见但存在），跨机器复制 vendor 会导致加载失败——永远不要手动复制 vendor 目录
最易被忽略的一点：Composer 不校验 PHP platform 版本是否满足 lock 文件里的要求。断网恢复后若 composer install 成功但运行时报 PHP version mismatch，得回头检查 composer.json 的 config.platform.php 字段是否和当前环境一致——这个字段不会写进 lock，但会影响依赖解析结果。
