Composer跨平台运行的关键在于统一使用正斜杠/、避免硬编码反斜杠、在目标环境重装vendor。路径拼接需用DIRECTORY_SEPARATOR或realpath，离线部署必须在目标系统执行composer install，Windows安装路径禁用空格和中文。
Composer 本身不转换斜杠，但只要你别硬编码 、别在 composer.json 里混用分隔符、别在 Windows 上打包后直接扔到 Linux 跑，它就能跨平台跑通——问题从来不在 Composer，而在你拼路径、写配置、打包部署时的手动干预。
composer.json 里路径必须全用 /，不是建议，是强制
PSR-4 映射、autoload-dev、scripts 中的路径字段（比如 "App": "src/" 或 "phpunit --configuration phpunit.xml"），所有斜杠都得是正斜杠 /。Composer 解析这些字符串时不走 DIRECTORY_SEPARATOR，也不做替换，它只认 /。
- 写成
"src"或"src\\"会导致映射失效，类加载直接跳过，报Class not found却查不到原因 -
scripts里命令本身不是路径问题，但如果你写"post-install-cmd": "copy .env.example .env"，那是在 Windows 上能跑，Linux 就崩——这不是斜杠的事，是 shell 命令不兼容 - 别试图用 PHP 代码动态生成
composer.json路径再写入，JSON 是声明式配置，不是运行时逻辑
__DIR__ 拼路径时别信“看起来像对的”
__DIR__ 在 Windows 下返回的是 C:/project/vendor 这种格式（注意：是正斜杠），PHP 7.4+ 内部自动处理后续拼接的 /composer/autoload_real.php。但你手动拼相对路径时，边界情况很脆。
- 写
__DIR__ . '/../src'在 WSL 挂载/mnt/c/或 Docker 绑定挂载 Windows 主机路径时，realpath()可能返回C:project endor/../src，导致require失败 - 安全写法是：
dirname(__DIR__) . DIRECTORY_SEPARATOR . 'src'，或者更稳一点：realpath(__DIR__ . '/../src') - 别拿
file_exists(__DIR__ . '/../src')当判断依据——它可能返回false，即使文件真实存在
离线部署失败？大概率是 vendor 没在目标系统重装
你在 Windows 上 composer install 打包了 vendor/，拷到 Linux 上就跑，失败不是因为斜杠，而是 autoload_classmap.php 里存了 C:projectsrcFoo.php 这种绝对路径。
- 离线打包前，必须在目标环境 OS 上执行：
composer install --no-dev --optimize-autoloader - 检查
vendor/composer/autoload_classmap.php和autoload_static.php，确认没有或盘符（如C:） - 运行
composer dump-autoload --optimize生成扁平化映射，减少运行时路径拼接环节 - CI/CD 中若用 Docker 构建，确保构建镜像的 base OS 和部署环境一致（比如都用 Ubuntu 22.04）
Windows 安装路径含空格或中文？直接重装
官方安装器默认路径 C:Program FilesComposerSetup 就是个坑——PHP 把空格当命令分隔符，报 Could not open input file 是必然的。
- 卸载后重装到无空格、无中文、无特殊字符的路径，例如
C:composer或D:devcomposer - 检查
where composer和where php，确保两者都在 PATH 里，且composer.bat文件真实存在 - 不要依赖 Git Bash 或 PowerShell 执行
composer命令；优先用 CMD，避免路径翻译污染
真正卡住人的，从来不是斜杠本身，而是你把路径当成字符串拼、当成命令写、当成资产直接拷贝——而忘了 Composer 的路径机制，本质是一套约定 + PHP 底层支撑，破坏任何一环都会断链。
