唯一可行方案是将条件逻辑下放到PHP层，在composer.json中仅声明统一入口src/bootstrap.php，由其根据PHP_OS_FAMILY动态加载对应平台文件，避免在autoload阶段抛异常或exit。
用 composer.json 的 autoload + files 配合环境变量不现实
Composer 的 autoload 是静态解析的，安装或 dump-autoload 时就写死映射了，$_SERVER 或 php_uname() 在那时根本不可用。别想着在 composer.json 里写条件判断——它不是 PHP 脚本，只是 JSON。
真正可行的路只有一条：把条件逻辑下放到 PHP 层，在自动加载之后、业务代码执行前做一次“动态分发”。
-
composer.json里只声明一个统一入口文件，比如src/bootstrap.php - 这个入口文件里用
php_uname('s')或PHP_OS_FAMILY判断系统，再require对应的平台专属文件 - 确保该入口在所有环境下都自动加载（用
"autoload": {"files": ["src/bootstrap.php"]}）
Windows 和 Linux/macOS 下路径处理差异必须显式处理
哪怕你用 PHP_OS_FAMILY 分出了 Windows 和 Unix，也别直接拼 \ 或 / —— Composer 自动加载本身不关心路径分隔符，但你的条件文件里如果涉及 fopen、file_get_contents 或 include，就容易崩。
- 用
dirname(__FILE__) . DIRECTORY_SEPARATOR . 'config' . DIRECTORY_SEPARATOR . 'platform.php'替代硬编码斜杠 - 避免在条件文件中使用
__DIR__拼接相对路径，因为__DIR__是当前文件所在目录，不是项目根目录 - 更稳妥的是在
bootstrap.php中先chdir()到项目根，或用getcwd()+ 显式路径定位
composer dump-autoload -o 会绕过条件逻辑？不会，但会跳过 files 自动加载
加了 -o（优化模式）后，Composer 会生成一个巨大的 vendor/composer/autoload_static.php，把类映射全编译进去。但它**仍然会执行 "autoload": {"files"} 列表里的文件**——前提是这些文件没被标记为“仅开发用”。
- 确认你的
files条目在"autoload"（不是"autoload-dev"）下 - 如果用了
classmap或psr-4同时又依赖files，注意加载顺序：files 总是最早执行，适合做初始化 - 运行
composer dump-autoload -o后，检查vendor/composer/autoload_static.php里是否还保留了$files数组，没有就说明配置位置错了
别在条件文件里抛异常或 exit，否则 autoload 失败难排查
很多人在 bootstrap.php 里写 if (PHP_OS_FAMILY === 'Windows') { require 'win-only.php'; } else { die('Not supported'); }，结果部署到 Linux 就报 Class not found，但错误堆栈根本看不到这行 die——因为 Composer 把 files 加载当作“前置静默动作”，异常会被吞掉或表现为后续类找不到。
- 条件分支里只做
require，不做exit、die、throw - 如果某系统确实不支持，应该让具体业务类在实例化时才报错，而不是在 autoload 阶段卡死
- 调试时临时加
error_log("Loaded for " . PHP_OS_FAMILY);，比echo更安全，不会干扰 HTTP 响应头
最麻烦的其实是 Docker 容器里 PHP_OS_FAMILY 返回 Linux，但宿主机是 Windows —— 这时候条件加载依据的是容器内核，不是开发机。得靠环境变量传入，而不是猜系统。
