Composer install 报错通常因 composer.lock 缺失、损坏或平台不匹配所致；需先验证 lock 文件存在性、Git 提交状态、JSON 有效性，再检查 PHP 版本/扩展是否满足 platform 约束，最后排查 vendor/ 一致性与文件权限问题。
composer install 报“no lock file present”或“Package not found”
这通常不是依赖真丢了，而是 composer.lock 文件缺失、损坏，或没被提交到 Git。Composer 一旦发现 composer.lock 不存在，就会退化为 composer update 行为——但你根本没想更新，只是想还原环境。
先确认三件事：
-
composer.lock是否真实存在于项目根目录（ls -la | grep composer.lock） - 它是否已
git add并推送到远端（尤其 CI/CD 节点拉代码时，漏掉这个文件等于没给钥匙） - 如果它存在但 JSON 解析失败（比如 Git 合并冲突残留
），<code>composer install会直接报错退出，而不是静默跳过
PHP 版本或扩展不满足 lock 文件要求
composer.lock 里写死了平台约束，比如 "platform": {"php": "^8.2"} 或 "ext-dom": "*"。本地 PHP 是 8.1 或没装 dom 扩展，composer install 就会卡在 “Your requirements could not be resolved”，但它真正想说的其实是：“你这台机器连基本运行条件都不达标”。
别急着删 lock 或加 --ignore-platform-reqs：
- 运行
php -v和php -m | grep dom确认实际环境 - 用
composer check-platform-reqs一次性列出所有缺失项（比猜快得多） - Ubuntu/Debian 下装扩展：
sudo apt install php8.2-dom（版本号必须匹配你的 PHP） - 临时绕过仅限调试，生产或 CI 中出现
--ignore-platform-reqs就等于放弃一致性底线
vendor/ 目录被忽略但 lock 文件又不一致
Git 忽略 vendor/ 是正确做法，但代价是：所有人必须严格依赖 composer.lock 的完整性。一旦 composer.json 被改过而没跑 composer update 生成新 lock，别人 composer install 就会失败或装错包。
排查顺序很关键：
- 执行
composer show --outdated，看输出是否为空——不为空说明 lock 和 json 已脱节 - 检查报错包是否真在
composer.json的require或require-dev里（注意末尾空格、引号不匹配） - 运行
composer why-not vendor/package:1.2.3定位冲突源头，而不是盲目重装 - CI 脚本中必须用
composer install --no-interaction --prefer-dist --optimize-autoloader，避免因 SSH 权限或 autoload 性能引发连锁失败
文件权限或系统锁导致写入失败
报错如 Could not write to vendor/autoload.php 或 Could not lock file ./composer.lock，本质不是磁盘满，而是所有权错配或文件系统不支持 POSIX 锁。
Windows / WSL2 用户最容易踩坑：
- 先运行
ls -ld vendor/ composer.lock，第三列不是当前用户名？那就sudo chown -R $USER:$USER vendor/ composer.lock - WSL2 下别把项目放
/mnt/c/，那里是 NTFS，flock()失效；移到~/project原生路径 - Windows 上报
Access is denied指向%APPDATA%\Roaming\Composer\Cache？右键该文件夹 → “安全” → 给当前用户“完全控制”权限 - 多个终端同时跑
composer require？必然争抢composer.lock，要么串行，要么用flock .git -c 'composer require xxx'
composer.lock 不是“一次生成，永久有效”的快照。它只保证“当时能跑”，不承诺长期可用——Packagist 下线、私有源域名变更、PHP 版本废弃，都会让一个看似完好的 lock 文件突然失效。修复永远从验证 lock 是否仍可信开始，而不是从重装 vendor 开始。 
