--optimize-autoloader 是强制 composer 静态扫描所有符合 autoload 配置的 php 文件，将类名与路径预生成到 autoload_classmap.php，不分析代码逻辑，仅依赖文件存在性及类声明匹配。
直接说结论：--optimize-autoloader 不是“让 Composer 更聪明”，而是强制它做一次静态扫描，把所有能确定类名的 .php 文件路径提前写进 autoload_classmap.php。它不分析代码逻辑，只认文件名和类声明——Foo.php 里没写 class Foo，就不会进 classmap。
为什么 composer dump-autoload -o 有时没效果
常见错误现象：执行完命令，vendor/composer/autoload_classmap.php 变大了，但 class_exists('AppHttpControllerHomeController') 还是慢，甚至返回 false。
- 你的类文件没被扫描到：检查
composer.json的"autoload": {"psr-4": {...}}是否覆盖了实际路径（比如写成"App\": "src/"，但类在app/下） - 文件名与类名不严格匹配：如
UserModel.php里定义的是class User，或用了class_alias()、匿名类、eval()动态加载，这些全被跳过 - 混入了不该扫的目录：如果
"autoload": {"classmap": ["tests/", "docs/"]}，这些路径下的文件也会被无差别收录，徒增体积、拖慢解析 - PHP opcache 没启用或配置太激进：即使 classmap 生成了，每次请求仍要重新解析那个几 MB 的数组——
opcache.memory_consumption不够、opcache.validate_timestamps=1都会让优化白费
--classmap-authoritative 是什么，什么时候必须加
它不是“更快”，而是“更狠”：一旦启用，Composer 运行时彻底关闭 PSR-4 fallback 查找逻辑，查不到 classmap 就直接报错，连 is_file("src/Http/Controller/HomeController.php") 这步都省了。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 只在部署环境用：Docker 构建阶段跑一次
composer install --no-dev --optimize-autoloader --classmap-authoritative，确保运行时行为可锁定 - 必须配合完整 classmap：如果某个类漏扫了（比如刚加的
app/Support/Helper.php没被dump-autoload -a覆盖），上线就Class not found，不会退回到 PSR-4 去碰运气 - 开发中禁用：改个类名、新增文件后不重跑
dump-autoload -a，立刻中断工作流
怎么验证 classmap 真的生效了
别只看文件大小或命令输出，得进 PHP 运行时确认：
- 执行
php -r "var_dump(require 'vendor/composer/autoload_classmap.php')['AppHttpControllerHomeController']);"，输出应为类似string(42) "app/Http/Controller/HomeController.php" - 对比关/开
--optimize-autoloader后的vendor/autoload.php内容：开启后，里面会多出对autoload_classmap.php的 require 和查表逻辑；未开启则走autoload_psr4.php+ 目录拼接 - Linux 上测试大小写敏感性：
php -r "var_dump(class_exists('appHttpControllerHomeController'));"应该返回bool(false)——Windows 下可能误返回true，掩盖命名空间末尾反斜杠缺失问题
最常被忽略的一点：classmap 优化不是独立生效的，它和 opcache、目录结构、命名空间写法三者绑定。少一个条件，-o 就只是生成了一个没人用的大数组。
