composer install 不会自动跳过不兼容包，必须主动用--ignore-platform-reqs或--ignore-platform-req=xxx绕过平台检查，但仅跳过安装校验，不解决运行时缺失扩展或依赖冲突问题。
composer install 本身不会自动跳过不兼容包——它默认严格校验平台要求（PHP 版本、扩展等）和依赖约束，不满足就报错中止。所谓“自动跳过”，其实是通过配置或参数主动绕过检查逻辑，但必须明确知道风险在哪。
为什么不能真“自动跳过”，只能“主动绕过”
Composer 的设计原则是“安装即可靠”：只要 install 成功，就默认环境能跑。所谓“不兼容包”，通常指两类问题：
– 平台不匹配（如 PHP 版本低、缺 ext-gd）→ 触发 platform requirements mismatch
– 依赖冲突（如两个包对 symfony/event-dispatcher 版本要求互斥）→ 触发 could not resolve packages
前者可用参数压制，后者必须改约束或删 composer.lock，不存在一键“自动跳过”的安全机制。
用 --ignore-platform-reqs 强制跳过所有平台检查
这是最常用、也最容易误用的方式。它让 Composer 忽略 php、ext-*、lib-* 全部声明，直接按 composer.lock 安装。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 适用场景：CI 构建时 PHP 版本略低但已确认运行时补丁兼容；本地开发临时验证某包行为
- 命令示例：
composer install --ignore-platform-reqs - 风险点：
laravel/octane依赖ext-swoole，忽略后php artisan octane:start必报Class 'Swoole\Http\Server' not found - 注意：
--ignore-platform-reqs不影响composer.lock内容，也不修复运行时缺失扩展——它只让安装过程“闭嘴”
用 --ignore-platform-req=xxx 精准跳过某一项
比全关更可控，适合团队协作或 CI 中保留部分校验。
- 值必须严格匹配依赖声明的平台名（大小写敏感），例如：
ext-imagick不能写成imagick - 只跳 PHP 版本：
composer install --ignore-platform-req=php - 只跳 GD 扩展：
composer install --ignore-platform-req=ext-gd - 跳多个需重复参数：
composer install --ignore-platform-req=php --ignore-platform-req=ext-mbstring - 这个参数从 Composer 2.2 起支持，旧版本无效
在 composer.json 中永久关闭 platform-check
避免每次命令都加参数，且作用范围仅限当前项目。
- 在
composer.json的config段添加："config": { "platform-check": false } - 效果等同于全局加
--ignore-platform-reqs，但不会污染其他项目 - ⚠️ 它不改变
config.platform的模拟行为（比如你写了"php": "8.2"，Composer 仍按 8.2 解析依赖） - 提交前务必同步团队：这等于把“环境是否达标”的责任从工具移交到人
真正容易被忽略的是：--ignore-platform-reqs 解决不了依赖树冲突，也掩盖不了运行时扩展缺失。它只是把报错时机从安装阶段推迟到第一次调用相关类或函数时。 临时调试可以压，但上线前必须回归真实环境验证。
