composer install 仅按 composer.lock 还原依赖，非安装新包；加包用 require，同步环境才用 install；其异常主因是 lock 文件缺失、php/platform 不匹配或 json/lock 不一致。
composer install 不是“安装新包”的命令，它只做一件事：严格按 composer.lock 文件还原依赖。想加包，该用 composer require；想同步环境，composer install 才是唯一可靠选择。
composer install 为什么有时没反应、报错或装错版本
根本原因不是网络或权限，而是它在静默校验三件事：
-
composer.lock是否存在 —— 没有就退化成composer update，行为完全失控 - 当前 PHP 版本和已启用扩展（如
mbstring、xml）是否满足composer.lock中各包声明的platform要求 -
composer.json和composer.lock是否一致 —— 若你手动改过composer.json的require，但没更新lock，install 会拒绝执行并报Your lock file does not contain a compatible set of packages
查错优先看报错开头三行，而不是滚动到底。常见线索：
• 出现 Your requirements could not be resolved → 检查 php -v 和 php -m | grep mbstring
• 提示 Could not find package xxx → 包名拼错，或源不可达（运行 composer config -g repo.packagist 确认是否为 https://mirrors.aliyun.com/composer/）
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
• 卡在 Loading composer repositories... → 换镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
composer install --force-reinstall 是什么，什么时候用
它不删 vendor/，也不动 composer.lock，只是强制重跑安装流程：重新解压、复制文件、生成 autoload、执行 post-install-cmd 脚本。适合以下场景：
- autoload 映射损坏（类找不到但文件明明存在）→ 配合
composer dump-autoload -o一起用 - 某个包的安装后脚本（如
Laravel的storage:link）没执行成功，但 vendor 已存在 - 想验证 lock 文件是否真能完整还原，又不想等删 vendor + 重拉全部包
别滥用：它跳过完整性校验（比如文件哈希比对），所以仅用于排错，不能替代 clean install。生产部署仍应走标准流程。
如何真正实现“一键同步”，避免协作翻车
光靠 composer install 不够，必须把约束写进配置、把检查嵌入流程：
- 在
composer.json的config.platform字段锁死目标环境 PHP 和扩展版本，例如："php": "8.1.25", "ext-mbstring": "8.1.25"—— 这样即使本地 PHP 是 7.4，install也按 8.1 解析依赖 - CI/CD 脚本里固定用：
composer install --no-interaction --optimize-autoloader --apcu-autoloader --no-dev - 部署前加一道校验：
composer validate --strict，确保composer.json和composer.lock成对且合法 -
composer.lock必须提交到 Git，vendor/绝对禁止提交
最常被忽略的一点：团队新人 clone 项目后第一件事不是 composer install，而是先确认有没有 composer.lock —— 没有就说明项目初始化不规范，不能直接装。
