Composer本身不区分操作系统，所谓“多系统适配”问题本质是依赖包的require声明（如ext-posix）或scripts中shell命令（如cp、rm）跨平台不可用所致；解决核心是通过config.platform按目标环境选包，并用运行时判断替代硬依赖，而非让Composer识别系统。
Composer 本身不区分操作系统，所谓“多系统适配”问题，本质是依赖包的 require 声明（如 ext-posix、ext-pcntl）或脚本行为（如 cp、rm -rf）在不同平台不可用导致的。解决方向不是让 Composer “识别系统”，而是控制它“按目标环境选包”+“避免运行时硬依赖”。
为什么 composer install 在 Windows 上报 ext-posix missing
这不是 Composer 故意报错，而是某个包（常见于 symfony/console 旧版、phpunit/phpunit 或 CLI 工具）在 require 中写了 "ext-posix": "*"。Windows 默认没有 ext-posix，PHP 也加载不了，Composer 就直接拒绝解析依赖树。
- 先定位谁加的：
composer show --tree | grep posix - 如果只是开发时用（比如本地跑测试），把它从
require移到require-dev更合理 - 如果必须运行，改代码：用
if (function_exists('posix_getpid')) { ... }替代无条件调用 - 临时绕过可用
composer install --ignore-platform-req=ext-posix，但别提交进 CI 或composer.lock
config.platform 怎么写才生效
config.platform 是唯一可控的跨平台声明手段，但它只影响 composer update 时的依赖解析，对 install 完全无效——除非你先用目标平台配置生成新的 composer.lock。
- 必须嵌套在
composer.json的"config": {}下，不能放顶层 - 扩展名必须带
ext-前缀，且大小写、连字符要和php -m输出完全一致（ext-xdebug✅，ext-xdebg❌） - 值可以是
true、"1.0.0"这类非空字符串，Composer 只检查“是否存在”，不校验版本 - 改完后必须执行
composer update --lock（或composer update），否则composer.lock仍按旧规则锁定
scripts 里哪些命令会跨平台失败
Composer 的 scripts 字段是纯 shell 命令，它不翻译、不兼容、不模拟。Windows cmd.exe 和 Linux bash 对命令语法、路径分隔符、工具链的支持完全不同。
-
"post-install-cmd": "cp config/.env.example .env"→ Windows 下cp不识别，应改用copy或切到 Git Bash/WSL -
"pre-deploy": "rm -rf public/build"→rm在 cmd.exe 中不存在，且-rf是 GNU 特有参数 - 路径硬拼接：
__DIR__ . '/../../tmp'在 Windows 上可能因反斜杠或空格路径失效；优先用sys_get_temp_dir()或realpath() - 更稳妥的做法：把逻辑抽成 PHP 脚本，用
file_get_contents()+file_put_contents()替代cp，用RecursiveDirectoryIterator替代rm -rf
离线部署时 vendor 目录为什么在 Linux 上加载失败
根本原因不是 Composer 生成了错误路径，而是你在 Windows 上执行了 composer install，然后把整个 vendor/ 拷过去——某些包的自动生成文件（如 autoload_classmap.php）里混用了反斜杠，或 realpath() 缓存污染了路径格式。
- 离线打包前，必须在与目标环境一致的 OS 上执行
composer install --no-dev --optimize-autoloader - 检查
vendor/autoload.php是否能被目标 PHP 正常require；若报failed to open stream，大概率是路径分隔符混用 - 运行
composer dump-autoload --optimize再打包，可减少动态路径拼接环节 - 确认
composer.lock中的platform字段与目标环境匹配（如"php": "8.1.25"），否则 classmap 可能漏掉文件
最常被忽略的一点：写了 config.platform 并不等于解决了问题——它只骗过了 Composer 的依赖解析器，没骗过 PHP 解释器。如果包里用了 match 表达式或 enum，而目标 PHP 版本不支持，composer install 成功了，运行时照样 Fatal error。
