Composer不转换斜杠但兼容双系统，因PHP 7.4+在Windows原生支持/作分隔符；__DIR__返回标准化路径，拼接后由PHP自动映射；硬编码反斜杠（如'src\SomeClass.php'）必须避免，composer.json中所有路径须用/；离线部署需在目标环境执行composer install并检查autoload_classmap.php无盘符或反斜杠。
Composer 本身不转换路径斜杠，但所有关键路径逻辑都默认兼容 Windows 和 Linux —— 前提是你别手动破坏它。
vendor/autoload.php 里的路径为什么在 Windows 下也能用 /？
因为 PHP 7.4+ 在 Windows 上原生支持正斜杠 / 作为目录分隔符。Composer 生成的 vendor/autoload.php 里这行代码：
require_once __DIR__ . '/composer/autoload_real.php';
中的 __DIR__ 返回的是 Windows 下标准化路径（如 C:/project/vendor），而 /composer/... 这段拼接后，PHP 内部会自动映射为系统能识别的形式。你不需要、也不应该用 str_replace('\', '/', __DIR__) 去“修正”它。
直播话术巡检系统(Windows版) — 实时语音转写、关键词检测、场景自动切换、告警推送、大屏可视化。支持 Windows VB-Cable 虚拟声卡音频采集，阿里云 ASR 实时识别。一键启动脚本，自动安装环境。
- 硬编码反斜杠（如
'src\SomeClass.php'）是唯一明确要避免的写法 - 所有
autoload、autoload-dev字段在composer.json中必须用/，这是 Composer 官方唯一认可的格式 - 不要在
scripts里写cp或rm -rf—— 这些不是路径问题，而是 shell 命令问题，和斜杠无关
为什么 __DIR__ . '/../../src' 在某些场景下会出错？
这不是 Composer 的锅，而是你拼路径时没考虑 Windows 对相对路径解析的边界情况。比如在 WSL 中挂载 /mnt/c/ 目录，或在 CI 中用 Docker 绑定挂载 Windows 主机路径到 Linux 容器时，realpath() 可能返回混用分隔符的结果（如 C:\project\vendor/../src），导致后续 require 失败。
- 真正安全的写法是：
dirname(__DIR__) . DIRECTORY_SEPARATOR . 'src' - 如果路径用于
require或include，优先走realpath()包一层：realpath(__DIR__ . '/../src') - 别依赖
__DIR__拼接后直接进file_exists()—— 它可能返回false，即使文件存在
离线部署时 vendor 路径“看起来一样却加载失败”怎么办？
常见于 Windows 开发、Linux 部署：你在 Windows 上 composer install 打包了 vendor，拷过去后 autoload_classmap.php 里存的却是 C:\project\src\... 这种绝对路径，Linux 根本找不到。
- 离线打包前，必须在目标环境 OS 上执行
composer install --no-dev --optimize-autoloader - 检查
vendor/composer/autoload_static.php或autoload_classmap.php，确认里面没有\或盘符（C:） - 运行
composer dump-autoload --optimize再打包，它会生成扁平化映射，减少对动态路径拼接的依赖 - 若发现某个第三方包（如旧版
phpunit/phpunit）在生成 autoload 文件时硬编码了反斜杠，要么锁定兼容版本，要么 fork patch
跨平台最易被跳过的点，不是斜杠怎么写，而是你有没有在代码里偷偷调用了 sys_get_temp_dir() 返回带空格的路径，或者在 exec() 里拼了 /tmp/cache 却没做 escapeshellarg() —— 这些地方不会报路径错误，但会让整个流程静默失败。
