vendor/autoload.php 在 Windows 上能用正斜杠是因为 PHP 7.4+ 原生支持 / 作目录分隔符，内部自动转义；composer.json 所有路径字段必须统一用 /，不可用 DIRECTORY_SEPARATOR 或反斜杠。
Composer 本身不转换路径斜杠，它靠 PHP 底层和约定来保证跨平台路径可用——只要你不手动破坏这个链条，vendor/autoload.php 在 Windows、Linux、macOS 上都能正常 require。
为什么 vendor/autoload.php 用 / 拼路径却能在 Windows 上工作？
PHP 自 7.4 起在 Windows 上原生支持正斜杠 / 作为目录分隔符。Composer 所有路径拼接（比如 __DIR__ . '/../some/path.php'）都基于这个事实，不依赖 DIRECTORY_SEPARATOR 动态替换。
-
vendor/autoload.php是安装时生成的静态文件，路径写死为/，但 PHP 内部调用系统 API 前会自动转成 - PSR-4 加载器（如
ComposerAutoloadClassLoader）解析psr-4映射时，对/和一视同仁 - 硬编码反斜杠（如
'src\Foo\Bar.php'）或混用（'src/FooBar.php'）才真会出错
composer.json 里所有路径字段必须用 /，不能用 DIRECTORY_SEPARATOR
composer.json 是声明式配置，不是运行时代码。它的 autoload、autoload-dev、scripts 字段中出现的路径（如 "src/": ["src/"] 或 "phpunit --configuration phpunit.xml"），官方只认正斜杠 /。
- 用
str_replace('\', '/', $path)或DIRECTORY_SEPARATOR改写composer.json中的路径——这是无效且危险的 - Windows 下写
"src\": ["src\"]会导致 PSR-4 映射失败，类找不到 -
scripts中的 shell 命令（如ls -la）不属于路径问题，而是另一类跨平台风险，得单独处理
离线部署时路径出错，大概率是 vendor 目录没在目标系统重装
你在 Windows 上 composer install 生成的 vendor/，直接拷到 Linux 上跑，require 报错如 failed to open stream: No such file or directory，根本原因不是斜杠，而是某些包的自定义加载逻辑或脚本路径在生成时就固化了开发机环境。
- 正确做法：离线打包前，在与目标环境一致的 OS 上执行
composer install --no-dev --optimize-autoloader - 运行
composer dump-autoload --optimize可减少动态路径拼接，生成扁平化映射，降低出错概率 - 检查
vendor/autoload.php是否能被目标 PHP 直接require；如果连这一步都失败，说明 autoload 文件本身已损坏或路径污染
bin-compat=full 不解决路径问题，只管脚本包装器
bin-compat=full 的作用仅限于让 Composer 在 Windows 上也生成 .bat 和 .cmd 包装器，对应 Linux/macOS 的 shell 脚本。它不碰任何 PHP 内部路径逻辑。
- 包装器只是启动入口，真正执行的还是
php xxx.php这类命令；路径是否有效，取决于xxx.php里怎么写require - 如果你的 bin 脚本里写了
require __DIR__ . 'libhelper.php';，哪怕有.bat也照样挂 - 验证兼容性最简单的方式：在干净 Windows 环境（无 WSL、无 Git Bash）下，直接运行
php bin/mytool，而不是mytool.bat
最容易被跳过的细节是：sys_get_temp_dir() 返回的路径可能含空格，而某些 exec 调用没加引号包裹，导致静默失败——这和 Composer 无关，但和你的路径处理是否健壮强相关。
