composer生产环境唯一靠谱起点是composer install --no-dev --optimize-autoloader，它跳过dev规则、编译psr-4为静态查找表、排除classmap；无效操作是dump-autoload -o；假延迟配置如通配符、手动引入vendor、files类型等会拖垮性能。
Composer 本身不支持“延迟加载类库”，它只负责按需加载类——所谓“延迟”，其实是自动加载机制的自然结果；真正要管的是如何避免把不该加载的东西塞进 autoload 流程里。
为什么 composer install --no-dev --optimize-autoloader 是生产环境唯一靠谱的起点
大型项目常误以为只要写了 PSR-4 就“自动延迟”了，其实不然：autoload 规则越多、路径越宽、目录越深，Composer 在运行时匹配命名空间的开销就越大。而 composer install --no-dev --optimize-autoloader 做了三件关键事：
- 跳过
autoload-dev下所有规则（比如"tests/": ["tests/"]、"docs/": ["docs/"]），这些在生产环境毫无意义，却会拖慢 PSR-4 匹配顺序 - 把有效的 PSR-4 前缀编译成静态查找表（写入
autoload_static.php），不再逐个file_exists()探路 - 彻底排除 classmap 生成（除非你显式配置了
"classmap"），因为全量 classmap 在 PHP-FPM 每次请求中反序列化几 MB 数组，比 PSR-4 查找还慢
⚠️ 注意：composer dump-autoload -o 在绝大多数项目里是无效操作——它不重建 classmap，也不清理 dev 规则，只是重写轻量文件。CI/CD 脚本里写这个等于白干。
哪些 autoload 配置项最容易“假延迟”并拖垮性能
你以为加了 autoload 就是“按需”，但有些写法会让 Composer 在每次请求中都做无谓扫描或失败 stat()：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"App\*": "src/"—— 这种通配符语法不合法，Composer 直接忽略，但开发者误以为生效，导致类找不到又没报错 -
"MyLib\": "vendor/mylib/src/"—— 把第三方包的 src 目录手动加进项目 autoload，破坏了 vendor 的隔离性，且让 Composer 多扫一层路径 -
"": ["app/Helpers/functions.php"]——files类型会在vendor/autoload.php初始化时无条件require_once，根本不是延迟，而是“启动即载” - 测试用的
"Tests\": "tests/"留在顶级autoload里，而非移到autoload-dev—— 生产部署后仍参与 PSR-4 匹配，白白增加字符串比对次数
验证方法：部署后检查 vendor/composer/autoload_psr4.php，确认只有真正需要在运行时加载的命名空间前缀存在。
真要“延迟加载整个类库”？别动 autoload，改用运行时 require_once 或服务容器绑定
某些场景下，你确实不想让某个大型 SDK（比如支付网关、AI 接口封装）在每次请求中都准备就绪，这时强行塞进 autoload 反而是错的：
- 把 SDK 的初始化逻辑封装进一个工厂类，首次调用时才
require_once '/path/to/sdk/autoload.php'（注意：是 SDK 自己的 autoload，不是你的项目） - 在 Laravel 中，通过
AppServiceProvider::boot()绑定接口实现，而不是在register()阶段提前实例化 - 对于纯函数工具集，删掉
files配置，改用function_exists('my_helper_func')+require_once手动触发加载
这类做法绕过了 Composer 的 autoload 机制，但也意味着你放弃了自动发现和命名空间映射——代价是可控的，收益是明确的：那个 SDK 的文件系统扫描和类解析，真的只发生在它被用到的那一毫秒。
最常被忽略的一点：autoload 性能瓶颈不在“加载”，而在“查找”。哪怕你什么都没用，只要 autoload 规则冗余，PHP 就得在每次请求中多跑十几轮字符串前缀比对和 stat()。删掉一行多余的 PSR-4 配置，可能比加十个缓存插件更有效。
