Composer跨平台需在目标系统重装vendor，因config.platform仅影响依赖解析；vendor/autoload.php用/安全是因PHP 7.4+在Windows原生支持正斜杠，但自定义路径须避免反斜杠和硬编码。
Composer 本身不区分操作系统，所谓“跨平台脚本统一体验”不是靠它自动适配系统，而是靠你控制 config.platform、规避硬编码路径、并在目标系统重装 vendor —— 否则 Windows 上生成的包在 Linux 上大概率 require 失败。
为什么 vendor/autoload.php 在 Windows 写 / 却能在 Linux 跑通？
PHP 7.4+ 在 Windows 上原生支持正斜杠 / 作目录分隔符，调用 realpath() 或 include 前会自动转换。Composer 生成的 vendor/autoload.php 全部用 / 拼接路径，这是安全的；但如果你在自定义脚本或包里写了 'src\Foo\Bar.php' 或混用 'src/FooBar.php'，就会出错。
实操建议：
-
composer.json中所有路径字段（autoload、scripts、bin）必须只用/，不能用DIRECTORY_SEPARATOR动态拼接 - 检查
vendor/composer/autoload_*.php文件里是否出现反斜杠字符串；有则说明该包未适配 PSR-4，需换版本或 fork patch - 运行
composer dump-autoload --optimize可生成扁平化映射，减少运行时路径拼接逻辑
如何让 composer install 在 Windows 开发机上拉到 Linux 线上可用的包？
关键不是“让 Composer 识别系统”，而是告诉它：“别查我本地有没有 ext-posix，就当我有”。这靠 config.platform 实现，它只影响 install/update 阶段的依赖解析，不改变运行时行为。
常见错误写法与修正：
- ❌ 把
"platform"放在composer.json顶层 → 必须嵌套在"config": {}下 - ❌ 写
"ext-gd": "^8.1"→platform只接受具体版本（如"8.1.25"）或布尔值true - ❌ 拼错扩展名，比如
"ext-xdebg"→ 必须和php -m输出完全一致（注意大小写、连字符） - ✅ 正确示例：
{ "config": { "platform": { "php": "8.1.25", "ext-xdebug": true, "ext-pcntl": true, "ext-posix": true } } }
离线部署时 vendor 目录拷来拷去为啥总报 failed to open stream？
根本原因不是斜杠，而是 vendor 目录没在目标系统重装。你在 Windows 上 composer install 生成的 vendor/，直接拷到 Linux 上跑，某些包的自定义安装脚本或 classmap 扫描结果已固化开发机路径，realpath() 返回值在跨平台挂载卷下也不一致。
必须这么做：
- 离线打包前，在与目标环境一致的 OS 上执行
composer install --no-dev --optimize-autoloader - 确认
composer.lock中的content-hash和platform字段匹配目标环境（比如"platform": {"php": "8.1.20"}） - 避免在
post-install-cmd里用__DIR__ . 'sub/file.php'这类写法；统一改用__DIR__ . DIRECTORY_SEPARATOR . 'sub' . DIRECTORY_SEPARATOR . 'file.php' - 用
COMPOSER_HOME和COMPOSER_CACHE_DIR隔离缓存路径，防止用户权限或路径格式污染
最易被忽略的一点：哪怕 config.platform 写得再全，只要 vendor 不在目标系统重装，autoload 就可能漏文件、脚本就可能找不到二进制——这不是配置问题，是构建流程错位。
