应使用--ignore-platform-reqs精准跳过平台检查，而非盲目全局忽略；它仅绕过php版本、扩展等校验，不解决运行时缺失问题，推荐配合platform-check验证或config.platform模拟目标环境。
Composer install 报错 “platform requirements are not met” 怎么办？
直接加 --ignore-platform-reqs 参数就行，这是最常用、最有效的绕过方式。它告诉 Composer 忽略 PHP 版本、扩展（如 ext-zip）、或已安装包的平台约束，适用于 CI/CD 构建、容器部署或本地开发环境版本不一致时。
但要注意：这不是“修复”，而是“跳过检查”。如果目标环境真缺 ext-gd 却强行忽略，运行时仍会报 Class 'GDImage' not found 这类错误。
-
composer install --ignore-platform-reqs：跳过所有平台要求（含 PHP 版本 + 扩展） -
composer install --ignore-platform-reqs=php：只跳过 PHP 版本检测（如项目 require PHP ^8.2，而你用 8.1） -
composer install --ignore-platform-reqs=ext-zip：只跳过特定扩展（支持逗号分隔，如--ignore-platform-reqs=ext-zip,ext-mbstring）
为什么 --ignore-platform-reqs 有时没生效？
常见原因是启用了 config.platform 配置——它会硬编码“模拟平台”，优先级高于真实环境，也高于 --ignore-platform-reqs。此时跳过检测会被平台配置覆盖。
查配置是否干扰：
composer config --list | grep platform
若输出包含 config.platform.php 或 config.platform.ext-*，说明有静态平台声明。解决方法是临时取消：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时禁用：
composer install --ignore-platform-reqs --no-config（跳过所有 config，包括 platform） - 临时覆盖：
composer install --ignore-platform-reqs --config-platform.php=8.1.0（强制设为兼容值） - 永久清理（谨慎）：
composer config --unset platform.php
CI/CD 中推荐怎么用？安全又可靠
在 GitHub Actions、GitLab CI 等场景下，--ignore-platform-reqs 常被滥用导致线上环境出问题。真正稳妥的做法是：只在构建阶段跳过，但确保运行环境满足实际依赖。
- 构建镜像时用：
composer install --no-dev --optimize-autoloader --ignore-platform-reqs - 同时在
Dockerfile中显式安装缺失扩展，例如：RUN docker-php-ext-install zip gd mbstring - 避免在
composer.json里写死"config": {"platform": {...}}—— 它会让本地和 CI 行为不一致，排查困难
替代方案：用 platform-check 提前验证
Composer 2.2+ 内置了 composer platform-check 命令，能明确告诉你哪项不满足，比盲目加 --ignore-platform-reqs 更可控。
执行后会列出所有未满足项，例如：
ext-zip : missing (required by doctrine/orm) php : 8.1.0 required, 8.0.30 present
这时你可以针对性处理：
- 装扩展：
sudo apt-get install php-zip（Debian/Ubuntu） - 升级 PHP，或改
composer.json的require.php范围 - 仅对确认无影响的项忽略，比如测试环境不需要
ext-sodium，就加--ignore-platform-reqs=ext-sodium
平台检测本身不是障碍，是提示——跳过容易，但漏掉真正缺失的扩展或版本不兼容，上线后才会暴露。
