composer install 在 Swoole 项目中不能直接热用，因其生成的 autoloader 单次初始化后不再重建，Worker 重启时仍沿用旧映射，导致类找不到或加载错版本；必须在 start() 前完成加载且禁止运行时动态 require。
composer install 在 Swoole 项目里为什么不能直接用？
因为 Swoole 项目常驻内存，composer install 生成的 autoloader 是单次初始化的，后续 Worker 进程重启（比如 max_request 触发）不会重建它——但你的代码可能已热更新，旧映射却还在，导致 Class not found 或加载错版本。
这不是命令本身的问题，而是它默认行为和 Swoole 生命周期不匹配。你必须确保：vendor/autoload.php 在 Swoole\Http\Server::start() 前完成加载，且之后不再变动。
- 所有类文件必须在启动前就位，禁止运行时
require新 PHP 文件 -
composer install必须在主进程（非 Worker）中执行完毕，不能放在onWorkerStart里 - 如果用了
autoload.files，里面的脚本不能注册全局函数或register_shutdown_function—— 否则每个 Worker 都会重复执行
上线部署时该用 composer install --no-dev 还是 --optimize-autoloader？
两者都要用，但顺序和时机有讲究：--no-dev 是安全底线，--optimize-autoloader（简写 -o）是性能关键。
Swoole 多 Worker 场景下，每次类加载都走 PSR-4 解析路径，开销明显；而优化后的 classmap 是静态数组查找，快一个数量级。
-
composer install --no-dev -o是生产环境标准组合，缺一不可 -
--no-dev不只是省空间：某些 dev 包（如phpunit）含 autoload.files 脚本，若被 Worker 加载可能引发 fatal error -
-o生成的vendor/composer/autoload_classmap.php会被vendor/autoload.php自动包含，无需额外操作 - 别用
--ignore-platform-reqs绕过ext-swoole检查——它掩盖的是根本没装扩展的事实，不是 Composer 的问题
composer.lock 被忽略或没提交，Swoole 项目会怎样？
不是“可能出错”，而是必然崩在 Worker 启动阶段：不同机器上 composer install 解出的依赖版本不一致，导致协程上下文、HTTP Server 行为、甚至 Swoole\Coroutine\run() 内部逻辑差异。
尤其当 lock 文件缺失时，Composer 退回到 composer.json 的模糊约束（如 "^5.0"），可能装上 v5.2.0（带新 API）而你的代码只适配 v5.1.x，启动时报 Call to undefined method。
-
.gitignore里删掉composer.lock这一行，必须提交 - CI 流水线第一步加
ls -la composer.lock校验，缺失则立即失败 - 本地改了
composer.json但没跑composer update更新 lock？别人composer install会直接报错退出 - 团队协作中，lock 文件比 composer.json 更权威——它定义了“此刻能跑通的唯一版本组合”
为什么 dump-autoload 对 Swoole 热更新无效？
composer dump-autoload 只重写 vendor/composer/ 下的映射文件，但 Swoole Worker 进程里的 $loader 实例早已初始化完毕，内存中持有的仍是旧的 prefixesPsr4 数组。
哪怕你手动 include vendor/autoload.php 二次加载，PHP 也不会覆盖已存在的 autoloader 实例（Composer 的 loader 是单例设计）。
- 真正生效的方式只有两种：重启整个 Swoole 主进程，或在
onWorkerStart中显式调用$loader->setPsr4()重置映射（仅限开发期配合 inotify） - 别指望
dump-autoload --optimize能解决热更问题——它只是加速加载，不改变生命周期 - 第三方包若在
autoload.files里注册了register_shutdown_function，Worker 重启后仍会再次注册，造成信号 handler 冲突
最易被忽略的一点：Swoole 的 reload_async 或 max_request 机制，看起来像“重启”，实际只是 fork 新 Worker 并 kill 旧进程——autoloader 实例从不重建，它始终是主进程启动那一刻的状态。
