composer install报“不支持该平台”，90%是因某包require中声明了本地缺失的扩展（如ext-posix）或php版本不匹配；config.platform仅影响update，对install无效，且须置于config对象内、扩展名须与php -m输出严格一致。
composer install 报“不支持该平台”，基本不是 Composer 故意拦你，而是它发现某个包的 require 里写了你系统根本没法加载的东西——比如 ext-posix（Windows 没这扩展）、php: ^8.2（你本地是 8.1），或者 ext-swoole 的预编译二进制只支持 x86_64（你在 M1 Mac 上跑 arm64）。它拒绝装明知跑不动的代码。
怎么快速定位是哪个包在要求不兼容的东西
先查 composer show --tree 输出里有没有带 ext- 或 php: 的硬依赖；再用 grep 快速过滤：
-
composer show --tree | grep posix—— 看谁引入了ext-posix -
composer show --tree | grep "php:"—— 找出锁死 PHP 版本的包 -
php -v和php -m | grep -E "posix|swoole|zlib"—— 确认你真没这些扩展或版本真不匹配
config.platform 改了为啥 composer install 还报错
config.platform 只影响 composer update 时的依赖解析，对 composer install 完全无效。它不参与安装阶段的校验，只管 lock 文件怎么生成。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须放在
composer.json的"config": {}对象内，不能写在顶层 - 扩展名要和
php -m输出完全一致：ext-xdebug✅，ext-Xdebug❌，xdebug❌ - 改完后必须运行
composer update --lock（或composer update），否则composer.lock还是旧规则锁定的 - CI 流水线里执行
composer install前，得确保composer.lock是用目标平台配置生成的
临时绕过但别乱用的两个参数
--ignore-platform-req=ext-xxx 和 --ignore-platform-reqs 都跳过校验，但风险差很远：
-
--ignore-platform-req=ext-posix：只跳过ext-posix检查，PHP 版本、其他扩展照常校验 -
--ignore-platform-reqs：彻底关闭所有平台检查（PHP 版本、全部扩展、ICU、lib-* 全放行） - 加了参数 ≠ 能跑。比如 PHP 7.4 强装 Laravel 11，
composer install成功，但php artisan第一行就报ParseError: syntax error, unexpected token "=" - 临时开发调试可用，但千万别提交带
--ignore-platform-reqs的 CI 脚本，也别把它写进composer.lock
scripts 字段跨平台就挂的真正原因
scripts 里的命令是纯 shell，Composer 不翻译、不模拟、不兼容。Windows 的 cmd.exe 和 Linux 的 bash 对语法、路径分隔符、工具链的支持完全不同。
- 别写
cp、rm -rf、ls、grep—— 这些在 Windows 命令行里根本不存在 - 路径拼接统一用正斜杠
/，PHP 7.4+ 会自动转义，别用DIRECTORY_SEPARATOR动态替换 - 删文件、复制资源，改用 PHP 原生函数：
RecursiveDirectoryIterator+FilesystemIterator，或copy()+unlink() -
bin-compat=full只控制生成.bat/.sh包装器，不重写脚本逻辑；执行前务必在干净 Windows 环境下直接运行php bin/mytool，而不是mytool.bat
最麻烦的不是报错本身，而是有人把 --ignore-platform-reqs 当成万能膏药，结果上线后 PHP Fatal Error 才暴露问题；或者改了 config.platform 却没跑 composer update --lock，导致本地看着正常、CI 直接崩。平台兼容性不是开关，是链条——每个环节都得对得上。
