最常用也最危险的方式是加--ignore-platform-reqs，它强制跳过php版本、扩展及系统库等全部平台校验，但不修复兼容性问题，仅让安装“假装看不见”环境不匹配；运行时仍可能因真实缺失而崩溃。
直接跳过 Composer 平台检查，最常用也最危险的方式就是加 --ignore-platform-reqs —— 它不修复任何问题，只让安装命令“假装看不见”PHP 版本、扩展缺失或库不匹配。真要这么干，得先确认运行时环境实际达标，否则装完就炸。
为什么 composer install 突然报 platform requirements 错误？
Composer 2.2+ 默认开启 platform-check，安装前会比对本地真实环境（php -v、php -m、ldconfig -p 等）和 composer.json 中声明的 config.platform 或依赖包自身的 require（如 "php": "^8.1"、"ext-gd": "*"）。不匹配就会中断，错误信息里通常带 Your platform does not meet the minimum requirements。
常见触发场景：
- CI 构建机 PHP 版本比
composer.lock记录的低（比如锁文件写的是 PHP 8.2，构建机是 8.1） - 本地没装
ext-mbstring，但某个依赖硬 require 它 -
composer.json里写了"config": {"platform": {"php": "8.3.0"}}，而你本地是 8.2
composer install --ignore-platform-reqs 到底做了什么？
它强制跳过全部平台校验逻辑：PHP 版本、所有扩展（ext-gd、ext-redis）、系统库（lib-curl）一概不查，依赖照常解析、vendor 照常写入。但注意：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--ignore-platform-reqs不改composer.lock，也不影响依赖选择策略 —— 它只绕过安装前那道门禁 - 如果依赖包内部用了 PHP 8.2 才有的函数，而你本地是 8.1，
install成功了，php index.php还是会报Undefined function -
create-project同样受限制，必须显式加该参数：composer create-project laravel/laravel myapp --ignore-platform-reqs
更安全的替代方案：精准忽略或动态覆盖
全局跳过太粗暴，容易掩盖真实问题。优先考虑以下方式：
- 只跳过 PHP 版本检查：
composer install --ignore-platform-req=php（注意值必须是php，不是7.4或8.1） - 跳过多个项，重复使用参数：
composer install --ignore-platform-req=php --ignore-platform-req=ext-mbstring - 临时“假装”有指定环境（推荐 CI 场景）：
composer install --platform=php:8.1.0 --platform=ext-gd:1—— 这会影响依赖解析，选包更准 - 项目级永久关闭（慎用）：在
composer.json的config段加"platform-check": false，只对当前项目生效
别碰 composer global config platform-check false，它会污染所有项目，协作时极易引发混乱。
CI/CD 里最容易翻车的三个点
很多团队在 GitHub Actions 或 GitLab CI 里加了 --ignore-platform-reqs 却仍上线失败，原因往往藏在这几处：
- 只加参数，没锁 PHP 版本：CI job 用默认 PHP（比如 GitHub Actions 的
ubuntu-latest默认是 PHP 8.3），但生产环境是 8.1 —— 参数让安装过了，运行时报错 - Docker 构建阶段没装扩展：
--ignore-platform-reqs让composer install成功，但后续php artisan optimize因缺ext-opcache直接崩 - 把参数写死在
Makefile或docker-compose.yml里：新成员 clone 项目后，连报错提示都看不到，以为环境没问题，调试半天才发现是被静默绕过了检查
真正关键的不是“怎么跳过”，而是“谁来保证运行时环境真满足要求”。参数只是临时通行证，不是兼容性担保书。
