composer install 报“不支持该平台”是因本地 php 版本或扩展与 composer.json 中 platform 约束不匹配，而非包本身问题；需通过 composer show --tree、php -v/-m 定位具体约束，config.platform 仅影响 update 而非 install，ci 中应确保 composer.lock 源自目标环境。

composer install 报“不支持该平台”其实是环境不匹配

这不是包本身有问题，而是 Composer 在检查 require 里的平台约束时发现本地 PHP 版本或扩展缺失。典型表现是 Windows 上报 ext-posix missing、PHP 版本低于 composer.json 中声明的最低要求、或 config.platform 与当前环境不一致。

先定位到底是哪个包/哪条约束在卡你

别急着加 --ignore-platform-reqs，先看清楚谁在提要求：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 运行 composer show --tree | grep -i posix 或 composer show --tree | grep -i "ext-，找谁把 ext-posix、ext-redis 这类写进了 require
• 用 php -v 和 php -m 确认实际 PHP 版本和已启用扩展，注意大小写和前缀（ext-xdebug ✅，xdebug ❌）
• 检查 composer.json 里 config 是否嵌套正确："config": { "platform": { "php": "8.1.0", "ext-gd": "8.1.0" } } —— 必须放在 config 对象内，不能放顶层

改 config.platform 只影响 composer update，对 composer install 无效

config.platform 是给 composer update 用的“模拟目标环境”，它不会改变 composer install 的行为。后者只照着 composer.lock 还原，根本不看你当前的 config.platform。

• 如果你改了 config.platform，必须紧接着运行 composer update --lock（或 composer update），否则 composer.lock 还是旧规则锁定的
• CI 流水线里执行 composer install 前，确保 composer.lock 是用目标平台配置生成的，而不是开发者本地生成的
• 临时绕过某项检查，用 composer install --ignore-platform-req=ext-posix，但别把这个参数写进 CI 脚本或提交到 composer.lock

scripts 字段跨平台失效不是 Composer 的错

scripts 里写的 shell 命令（比如 cp、rm -rf、grep）在 Windows 上根本不存在，Composer 不做翻译也不兼容。

• 路径统一用正斜杠 /，PHP 7.4+ 会自动处理，别用 DIRECTORY_SEPARATOR 动态拼接
• 删文件、复制资源改用 PHP 实现：RecursiveDirectoryIterator + FilesystemIterator，或 copy() + unlink()
• bin-compat=full 只控制是否生成 .bat/.sh 包装器，不重写脚本逻辑；测试时直接运行 php bin/mytool，别依赖 mytool.bat

真正卡住的地方往往不是报错那一行，而是 composer.lock 里锁死的平台约束和本地环境之间的隐性错位——尤其当多人协作、CI/CD 使用不同基础镜像时，这种错位比版本冲突更难被一眼发现。