Composer跨平台依赖管理需显式配置config.platform并更新lock文件，否则install仅机械还原lock中包，不校验目标环境扩展兼容性；platform仅影响update阶段解析，必须配合composer update --lock生成适配锁文件，install才有效。
Composer 本身不主动处理多平台支持，所有“跨平台”行为都取决于你是否显式用 config.platform 告诉它目标环境长什么样；没配就默认按本地 PHP 和扩展状态解析依赖，结果就是开发能装、上线跑崩。
为什么 composer install 在 Windows 装的包，到 Linux 上会报 ext-gd 找不到？
因为 Composer 默认不检查目标平台能力，composer install 只机械还原 composer.lock 里记录的包——哪怕 lock 文件里锁的是一个声明了 "ext-gd": "^8.2" 的版本，而你的 CentOS 服务器只有 GD 8.1 或根本没装，它也照装不误。
真正起作用的是 config.platform：它让 Composer 在 update 阶段“假装”运行在目标平台上，从而提前排除不兼容候选版本。
- 必须把 platform 配置写进
composer.json的"config": { "platform": { ... } }里，不能放顶层或全局 - 值必须是对象，比如
"ext-gd": "8.1.20"，不能写成"ext-gd": "^8.1"或"ext-gd": true - 改完
config.platform后，必须运行composer update --lock（或composer update）才能生成适配新平台的 lock 文件 -
composer install永远不重新解析依赖，它只认 lock 文件；所以 CI 流水线里执行install前，得确保 lock 是用目标平台配置生成的
如何让 dev 环境装 xdebug、prod 环境跳过校验？
别指望 Composer 自动识别环境变量或操作系统，它没有这功能。你要么伪造扩展存在性，要么彻底绕过检查。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
如果只是避免因缺 ext-xdebug 导致 composer install 报错（而你又确定线上不会加载任何依赖它的代码），最干净的做法不是配 platform，而是部署时加参数：
- 线上执行：
COMPOSER_PLATFORM_CHECK=0 composer install --no-dev，直接关闭所有平台校验 - 或者更细粒度地忽略特定项：
composer install --ignore-platform-req=ext-xdebug --no-dev - 若坚持用
config.platform，写"ext-xdebug": "3.1.5"即可，但注意：这会让 Composer 认为扩展“已存在”，不验证真实状态——适合 CI 构建镜像，不适合本地调试环境混用
Windows 和 Linux 下扩展名不同（.dll vs .so）导致 autoload 失败怎么办？
Composer 不管扩展文件后缀，autoload 机制也不处理这个。问题出在包内代码硬编码了扩展加载逻辑，或 require 条件写死了扩展名。
典型表现是 extension_loaded('yaml') 返回 false，即使 php.ini 已启用该扩展。
- 不要在
composer.json的require中写"ext-yaml": "*"，它不区分平台，且无法解决运行时加载失败 - 改用运行时检测，比如用
function_exists('yaml_parse')替代扩展名判断 - 若必须强制依赖，可在
config.platform中设"ext-yaml": "*"，让 Composer 忽略存在性检查，把验证交给运行时 - CI 中应显式验证：
php -m | grep yaml，而不是依赖 Composer 的“安装即可用”假象
最容易被忽略的一点：platform 配置只影响依赖解析阶段，对运行时零作用；很多人配了却没更新 lock 文件，或在 install 时误以为它会动态生效——结果还是装了一堆跑不起来的包。
