应使用 composer install --optimize-autoloader（或 -o），它在安装依赖时生成 classmap 并优化自动加载；dump-autoload -o 不重建 classmap，多数情况下无效。
Composer 本身不提供运行时按需加载能力，它只生成自动加载映射；真正的“按需”由 PHP 的 spl_autoload_register 在 new 或 static::class 等触发时才执行文件加载。优化的关键不是让类“更懒”，而是让查找过程更快、更精准、更少干扰。
psr-4 配置写错导致类根本找不到
PSR-4 是最常用也最容易配挂的加载方式。它靠命名空间前缀和路径的静态映射推导文件位置，一旦拼写或结构不一致，类就永远加载失败——不是慢，是直接 Class "AppConsoleCommandsDeployCommand" not found。
- 检查
"App"是否末尾有反斜杠：必须是"App"，不能是"App"或"App\"（后者在 JSON 中会被转义成单反斜杠，实际效果一样，但易混淆） - 确认目录结构与命名空间严格对齐：若写
"App": "app/"，则AppConsoleCommandsDeployCommand必须对应app/Console/Commands/DeployCommand.php，中间不能多一层app/App/Console/... - 多个前缀并存时，顺序影响匹配：越具体的前缀（如
"AppConsole"）建议放在更前面，避免被宽泛前缀（如"App"）提前截断
composer install -o 和 dump-autoload -o 到底该用谁
生产部署时，composer install --optimize-autoloader（简写 -o）才是真生效的命令；composer dump-autoload -o 大多数情况下只是“看起来在优化”，并不会重建 vendor/composer/autoload_classmap.php。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
install或update过程中才会扫描源码、生成 classmap 文件；dump-autoload默认只刷新 PSR 映射和autoload_static.php - 只有当你显式配置了
"classmap": ["src/"]或加了--classmap-authoritative，dump-autoload -o才会真正生成 classmap - CI/CD 脚本里必须固化为：
composer install --no-dev --optimize-autoloader
--classmap-authoritative 开启后 Class not found 怎么办
这个参数不是“加速开关”，而是“信任开关”：它让 Composer 完全放弃 fallback 查找，类不在 classmap 里就立刻报错，不尝试拼路径、不调 file_exists()。报错说明 classmap 漏了类，不是配置错了，是生成没覆盖到。
- 新增类后没重新运行
composer install -o：classmap 不会自动更新，必须重装或重 dump（且要带-o+-a） - 用了
"files"加载全局函数（如"app/Helpers/functions.php"）：这类文件不会进 classmap，但开启-a后仍能加载（因为files是独立逻辑），别误以为它们也被“禁止”了 - 某些运行时动态注册的类（如 Laravel 的服务容器绑定）：它们不对应物理文件，本来就不该出现在 classmap 里，跟
-a无关
autoload-dev 和 exclude-from-classmap 不是可选项，是必选项
开发依赖（如 phpunit/phpunit、fakerphp/faker）默认也会被写入 autoload map，拖慢整个加载链。不分离、不排除，性能损失是实打实的。
- 把测试工具类的 PSR-4 规则移到
"autoload-dev"下，而不是顶级"autoload" - 生产部署必须加
--no-dev：此时 Composer 根本不解析autoload-dev里的任何规则 -
"exclude-from-classmap"只对classmap生效，用来跳过测试文件、示例、legacy 代码等；路径是相对composer.json的，支持*，例如"tests/*"、"examples/" - 注意：
exclude-from-classmap对"files"无效——想控制全局函数加载，只能删条目或拆到autoload-dev.files
真正难的不是加几个参数，而是理解每个参数背后控制的是哪一段加载流程：是映射生成阶段？是运行时查找策略？还是文件引入时机？漏掉任意一环，优化就变成幻觉。
