--ignore-platform-reqs仅跳过安装校验，不解决跨平台兼容；真正运行失败主因是预编译二进制不匹配，需用"bin-compat": "full"或config.platform锁定目标环境。
直接跳过平台架构检查就能装上，但装上不等于能跑——--ignore-platform-reqs只是绕过校验，不是跨平台兼容方案。
为什么composer install报“不支持的架构”
Composer 在解析 composer.lock 时会比对当前 PHP 的架构（如 php-64bit、php-32bit）与 lock 文件中记录的 platform 字段。常见触发场景：
- 在 macOS（ARM64）上装为 Linux x86_64 构建的 lock 文件
- CI 流水线用 PHP 8.2 Alpine 镜像生成 lock，开发者本地是 PHP 8.3 Windows + 32bit
- 依赖包含预编译二进制（如
spatie/browsershot调用 Puppeteer），其bin/脚本绑定目标平台
错误信息通常是：Your lock file does not contain a compatible set of packages 或明确提示 php-64bit 不匹配。
--ignore-platform-reqs 和 --ignore-platform-req=xxx 怎么选
全量跳过太危险，按需忽略更可控：
-
composer install --ignore-platform-reqs：跳过所有平台检查（PHP 版本、扩展、架构），仅限本地调试或 CI 临时绕过 -
composer install --ignore-platform-req=php-64bit：只忽略位数约束，保留 PHP 版本和ext-gd等关键扩展校验 - 多个忽略项用空格分隔：
--ignore-platform-req=php-64bit --ignore-platform-req=ext-sodium - 语法错误写法：
--ignore-platform-reqs=ext-xdebug（--ignore-platform-reqs不接受参数值）
注意：php-64bit 和 php-32bit 是 Composer 内部标识，不是 PHP 自身常量，不能写成 arch 或 architecture。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真正影响运行的不是安装，是 vendor/bin 脚本
即使 composer install 成功，vendor/bin/phpunit 在 macOS 上仍可能报 Bad CPU type in executable，因为：
- 该脚本是预编译二进制（如
phpunit.phar或 musl 编译的可执行文件），与宿主机不兼容 -
--ignore-platform-reqs不重编译、不替换二进制，只跳过 PHP 包 autoload 注册阶段的校验 - 解决方向是改用源码安装：确保包提供
bin/下的 PHP 入口（#!/usr/bin/env php），而非 shell wrapper
为此需配合："bin-compat": "full" + 删除 vendor/bin 后重新 composer install，让 Composer 生成带完整 bootstrap 的包装器（Linux/macOS 是含 autoload 加载逻辑的 PHP 脚本，Windows 是调用 composer.phar 的 .bat）。
config.platform 才是长期适配的核心
靠临时参数治标，靠 config.platform 治本——它让依赖解析阶段就锁定目标环境能力：
- 写法必须在
composer.json顶层config字段内："config": { "platform": { "php": "8.2.12", "php-64bit": "1" } } - 不是
config.platform.php-64bit，也不是顶层platform字段（那属于旧版写法，已弃用） - 该配置只在
composer update时生效；install完全依赖 lock 文件，改了 config 也无效 - 若已有不兼容 lock，必须删掉
composer.lock并composer update --no-dev重建
最后提醒：架构兼容性问题最容易被忽略的点，是二进制文件本身——--ignore-platform-req=php-64bit 能让你装上，但 vendor/bin/pest 里如果硬编码了 exec('ls') 或路径拼接 /tmp/cache，照样在 Windows 或 Alpine 上静默失败。
