composer本身不支持热重载，需配合文件监听工具（如php-watch）和非优化自动加载（禁用-o/-a、OPcache等）实现。
Composer 本身不支持热重载（hot reload），它只是一个依赖管理器，composer install 和 composer dump-autoload 都是手动触发的静态操作。所谓“热重载”，必须由外部工具监听文件变化、触发重新加载逻辑，Composer 只负责提供可被动态重载的自动加载机制基础。
composer dump-autoload -o 与 -a 的区别直接影响热重载可行性
热重载能否生效，取决于自动加载器是否能快速响应新类/修改后的类。关键在生成的 autoload 文件是否支持增量更新：
-
composer dump-autoload -o（optimize）生成扁平化的vendor/composer/autoload_classmap.php，类名到路径映射固化，修改类文件后必须重新运行该命令，否则不会生效 -
composer dump-autoload -a（classmap-authoritative）更激进，会忽略 PSR-4 动态查找，完全依赖 classmap，同样需手动重建 - 真正适合热重载的是默认模式（无
-o或-a）：PSR-4 映射靠目录结构实时解析，只要文件已存在且命名规范，require或new时就能自动定位——但前提是 autoloader 没被“固化”或缓存
PHP 内置服务器 + 自定义 autoloader 不触发 Composer 默认加载器
很多热重载方案绕过 Composer 的 autoload.php，自己写一个简单 PSR-4 加载器，导致 vendor/ 中的包无法自动加载，或与 Composer 的加载顺序冲突。正确做法是复用 Composer 的 loader：
require __DIR__ . '/vendor/autoload.php'; // 在每次请求前重置（仅开发环境！） if (getenv('APP_ENV') === 'dev') { // 强制刷新 Composer 的 PSR-4 查找缓存（如果用了 opcache，还需 opcache_invalidate） $loader = require __DIR__ . '/vendor/autoload.php'; $loader->setClassMapAuthoritative(false); // 禁用权威 classmap $loader->setApcuPrefix(null); // 禁用 APCu 缓存（如有） }注意：$loader->unregister() + $loader->register() 并不能重载已加载类；PHP 类一旦加载就驻留内存，热重载本质是“让下一次请求加载新版本”，不是运行时替换。
配合 watchexec / nodemon / php-watch 实现文件监听触发 reload
真正起作用的是进程级重启工具。以 php-watch 为例（轻量、专注 PHP）：
- 安装：
npm install -g php-watch或composer global require "sensio/php-watch" - 启动：
php-watch --on-restart "composer dump-autoload" --ext "php" --path "src/" server.php - 关键点：监听
src/下的.php文件，一旦变化就执行composer dump-autoload（无-o），再重启server.php进程 - 若用
watchexec（更通用）：watchexec -e php -w src/ --on-change "composer dump-autoload && php server.php"
⚠️ 注意：server.php 必须是阻塞式 CLI 服务（如 php -S localhost:8000 router.php），不能是常驻 long-running 进程（如 swoole），否则重启无效；同时确保未启用 OPcache（opcache.enable=0）或已配置 opcache.file_update_protection=0。
现代替代：使用 symfony Local Web Server 或 laravel Sail 的内置 watch
如果你用的是 Symfony 或 Laravel，别自己搭热重载：
- Symfony：
symfony server:start --no-tls --watch自动监听src/和templates/，变更后软重启（无需dump-autoload，因它用的是 dev-mode 的非优化 loader） - Laravel Sail：
sail artisan serve --watch同理，底层调用php-watch并预置了 Composer autoloader 刷新逻辑 - 它们都默认跳过
-o，并禁用 OPcache，这是热重载能工作的隐含前提
手动拼凑热重载容易漏掉 OPcache、APCu、classmap 权威性这些细节，最终表现就是“改了代码但没反应”——问题往往不在监听，而在加载器卡在旧映射里。