“平台不匹配”指composer检测到包依赖的php版本或扩展（如ext-posix、php:^8.2）与本地环境不一致，拒绝安装明知无法运行的代码；config.platform仅影响update，install只认composer.lock，绕过需用--ignore-platform-req=xxx（精准）或--ignore-platform-reqs（高风险）。
composer install 报“平台不匹配”到底在报什么
它不是在说你的电脑型号不对，而是在告诉你：某个包的 composer.json 里写了 "ext-posix": "*" 或 "php": "^8.2"，但你本地 PHP 没加载这个扩展、或版本是 8.1 —— Composer 默认拒绝装“明知跑不动”的代码。
常见触发场景：
- Windows 上装了带
ext-posix依赖的包（比如老版symfony/console） - macOS M1/M2 机器装了只提供 x86_64 预编译二进制的扩展（如某些
ext-swoole版本） - PHP CLI 版本是 8.0，但
composer.json的config.platform.php写成"8.2.0"，且composer.lock是用该配置生成的
config.platform 只对 composer update 生效，别乱用
config.platform 不是“让低版本 PHP 假装高版本”，它只在 composer update 时影响依赖解析逻辑；composer install 完全无视它，只照着 composer.lock 里的记录还原。
正确用法：
- 必须放在
composer.json的"config"对象内，不能写在顶层 - 字段名严格匹配
php -m输出（ext-gd✅，gd❌，ext-xdebug✅，ext-Xdebug❌） - 改完后必须执行
composer update --lock，否则composer.lock还是旧规则 - CI 流水线里执行
composer install前，要确保composer.lock是用目标平台配置生成的
--ignore-platform-req=ext-xxx 和 --ignore-platform-reqs 的实际效果差异
两者都跳过校验，但风险等级完全不同：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--ignore-platform-req=ext-redis：只绕过 redis 扩展检查，PHP 版本、其他扩展仍照常校验 -
--ignore-platform-reqs：彻底关闭所有平台检查（PHP 版本、所有扩展、ICU、lib-* 全放行）
注意：加了参数 ≠ 能跑。比如你在 PHP 7.4 强装 Laravel 11，composer install 成功，但 php artisan 第一行就 Fatal error: Uncaught ParseError: syntax error, unexpected token "=" —— 因为 Laravel 11 用了 PHP 8.2 的新语法。
临时调试可用，但绝不能提交到 composer.lock 或写进 CI 脚本。
跨架构二进制扩展（如 ext-swoole、ext-protobuf）安装失败怎么办
这类扩展通常提供预编译的 .so 文件，但只打包了特定架构（x86_64 或 aarch64）。M1/M2 Mac 用户最容易踩坑。
解决路径：
- 先确认扩展是否真支持当前架构：
php -i | grep "Architecture"看输出是aarch64还是x86_64 - 查包的 Packagist 页面或 GitHub Releases，找对应架构的版本（比如
swoole/swoole-srcv5.1.0+ 开始提供 aarch64 构建） - 若官方没提供，改用源码编译：
pecl install swoole（自动适配当前架构），前提是已装好php-dev和gcc - 避免在
composer.json中硬 require 二进制扩展包，改用require-dev+ 条件判断封装调用逻辑
真正卡住的点往往不在 Composer 本身，而在扩展能否被 PHP 加载 —— php -m 看不到名字，extension_loaded('swoole') 返回 false，说明扩展根本没进 PHP 运行时，Composer 装得再顺利也没用。
