composer install 必须有 composer.lock，因为其本质是“还原环境”而非“安装依赖”，严格按锁文件中的精确版本、哈希值和依赖树执行，完全忽略 composer.json 中的 ^ 或 ~ 等版本约束；缺失或损坏时会退化为不可控的 update 行为，导致构建失败、类找不到等一致性问题。
composer install 为什么必须有 composer.lock？
因为 composer install 的本质不是“装依赖”，而是“还原环境”——它只读 composer.lock，完全忽略 composer.json 中的版本约束（比如 "^8.0"）。一旦 lock 文件缺失或损坏，命令就会 fallback 到 update 行为，结果不可控。
常见误操作：刚 clone 项目就直接 composer install，失败后反复重试，却没检查 composer.lock 是否被 .gitignore 排除、是否提交到远端。CI 环境里报错，90% 源头在此。
-
composer.lock必须存在且内容完整（JSON 格式合法、含 packages 数组） - 若项目由他人交付，务必确认该文件已 git add && git commit
- 执行
composer install --dry-run可预检 lock 文件可读性，不实际写 vendor
报 “Your requirements could not be resolved” 是什么问题？
这不是依赖冲突，而是环境不匹配。错误提示里带 ignore-platform-reqs 是临时绕过开关，不是修复手段；加了它，后续运行大概率报 Class not found 或扩展缺失致命错误。
真实原因集中在三类平台前提未满足：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- PHP 版本低于 lock 中某包声明的
require.php（例如 lock 里monolog/monolog v3.5.0要求php: ">=8.1"，而你本地是 8.0.30） - 关键扩展未启用：
ext-mbstring、ext-xml、ext-curl缺一不可，composer diagnose会明确标出 -
composer.json顶部"config": {"platform": {...}}写死了平台版本（如"php": "8.2.10"），但实际 PHP 是 8.1 —— 这个配置会覆盖真实环境，导致 install 阶段直接拒绝
CI/CD 和生产部署该用哪些参数？
线上环境只允许一条标准命令：composer install --no-dev --optimize-autoloader。任何额外 flag 都可能埋下隐患。
-
--no-dev：跳过require-dev中的包（PHPUnit、PHPStan、debugbar），避免把开发工具打进生产镜像 -
--optimize-autoloader：生成vendor/composer/autoload_classmap.php，提升类加载速度，尤其对 APCu 生效 - 绝对禁止
--ignore-platform-reqs或--force—— 它们掩盖的是真实环境缺陷，不是问题本身 - 不要混用
composer update：上线那一刻等于放弃版本控制权，lock 文件形同虚设
install 成功但项目跑不起来，哪里出错了？
成功 ≠ 可用。composer install 只负责把文件解压进 vendor/，不保证自动加载生效、不校验路径映射、不检测框架约定。
最常被跳过的验证点：
- 检查
vendor/autoload.php是否被正确 require —— Laravel 的index.php、Symfony 的public/index.php都依赖它 - 运行
composer dump-autoload强制刷新映射（尤其在手动改过autoload配置后） - 确认
composer.json中的"autoload"和"autoload-dev"没拼错键名或路径（比如"psr-4": {"App\": "app/"}写成"psr4"就失效） - 第三方包若用了
Composer Installers（如 WordPress 插件、Laravel Package），需确保其type字段与安装器匹配，否则路径错位导致类找不到
autoload 错位比依赖装错更难排查，因为它不报错，只静默失败。
