composer autoloader 路径不一致的典型表现是 require 失败或 class not found，因 windows 用反斜杠、linux 用正斜杠；官方要求 composer.json 中所有 autoload 路径必须统一用 /，php 7.4+ 原生兼容，__dir__ 拼接 / 后由 php 自动映射，硬编码 或混用分隔符会导致加载失败。
Composer autoloader 在 Windows 和 Linux 下路径不一致的典型表现
Composer 的自动加载机制在跨平台项目中经常因路径分隔符差异出问题：Windows 用 ，Linux/macOS 用 /，而 PHP 的 autoload_real.php 默认依赖 str_replace 或硬编码路径拼接，一旦类文件路径被错误解析（比如 My\Namespace 映射到 srcMyNamespace），require 就会失败，报错类似 Warning: require(...): failed to open stream 或 Class not found。
检查 composer.json 中 autoload 配置是否使用正斜杠
Composer 官方明确要求：所有 psr-4、psr-0 和 classmap 的路径映射必须使用正斜杠 /，即使你在 Windows 上编写配置。Composer 内部会统一转换为当前系统的分隔符，但前提是输入合法。
-
psr-4映射值写成"App\": "src/App"✅（推荐） - 不要写成
"App\": "src\App"❌（Windows 用户易犯） - 避免在路径中混用变量或动态拼接，如
"lib/".DIRECTORY_SEPARATOR."utils"—— Composer 不解析 PHP 表达式 - 运行
composer dump-autoload -o后检查生成的vendor/composer/autoload_psr4.php，确认键值对中的路径字符串不含
自定义 autoloader 中避免手动拼接路径
如果你在项目中额外注册了自定义加载器（比如用 spl_autoload_register），切忌用 __DIR__ . 'MyClass.php' 这种写法。PHP 的 include/require 能正确处理正斜杠，但反斜杠在某些 PHP 版本或 SAPI（如 CLI vs Apache mod_php）下可能被误解析为转义字符。
- 统一用
/拼接：__DIR__ . '/My/Class.php' - 更稳妥的方式是用
str_replace('\', '/', __DIR__) . '/My/Class.php'强制标准化 - 优先使用
dirname(__FILE__) . '/My/Class.php'——dirname返回的路径已适配当前系统 - 若需兼容旧版 PHP（__DIR__ . '/sub/' . $class 直接拼接类名，先用
strtr($class, '\', '/')转义命名空间
CI/CD 环境中 vendor 目录跨平台重建的风险
如果 CI 流水线在 Linux 上生成 vendor/，再把整个目录复制到 Windows 开发机上直接使用，会出问题：Composer 生成的 autoloader 文件（如 autoload_classmap.php）里路径是 Linux 格式（/），但 Windows PHP 可能因 realpath 或 opcache 缓存导致路径解析失败，尤其当项目根目录含空格或非 ASCII 字符时。
- 禁止跨系统复用
vendor/目录 —— 每个环境都应独立执行composer install - 确保
composer.lock提交进 Git，它保证依赖版本一致，但不保证路径兼容性 - 在 GitHub Actions / GitLab CI 中，用
composer install --no-dev --optimize-autoloader，而非复制本地vendor/ - 若必须调试跨平台路径问题，临时加一句
var_dump(realpath('src/My/Class.php'));看实际解析结果
