composer 2.x 中 composer install --no-dev --optimize-autoloader 才真正生成 classmap，dump-autoload -o 默认不生效；必须验证 autoload_classmap.php 是否存在且非空，缺 --no-dev 或命名空间路径错误（如漏反斜杠）会导致映射失败。
composer install -o 不等于 dump-autoload -o
升级到 Composer 2.x 后，最常踩的坑是沿用旧习惯：在 CI/CD 或部署脚本里写 composer dump-autoload -o，以为它能生成 classmap 并提速。实际上，dump-autoload -o 在 Composer 2 中基本不生效——它只重写 autoload_static.php 和 autoload_files.php，但不会重建 vendor/composer/autoload_classmap.php，除非你同时加了 --classmap-authoritative 或项目里明确定义了 "classmap" 配置项。
真正触发 classmap 生成的，只有 composer install 或 composer update 这两个命令。所以升级后必须把部署命令从：
composer dump-autoload -o
改成：
composer install --no-dev --optimize-autoloader
-
--optimize-autoloader（或-o）强制生成 classmap -
--no-dev确保 dev-only 的 autoload 配置（比如autoload-dev块）不混入生产 classmap - 缺一不可；漏掉
--no-dev可能导致测试类路径被扫进 classmap，膨胀文件体积
检查 autoload_classmap.php 是否真被生成
升级后不能只看命令是否跑过，得验证结果。执行完 composer install --no-dev --optimize-autoloader 后，立刻检查：
-
vendor/composer/autoload_classmap.php文件是否存在且非空（大小通常几百 KB 起） -
vendor/composer/autoload_real.php里是否有$loader->addClassMap(...)调用（说明 classmap 已被注册） - 如果文件存在但内容是空数组
[]，大概率是composer.json里autoload配置有误，比如命名空间末尾少反斜杠、路径拼错、或目录不存在
常见错误配置示例："App": "app/"（缺反斜杠）→ 应为 "App\": "app/"；"": "legacy/"（空前缀）→ 会无差别扫描整个 legacy/ 目录，拖慢生成速度且易引入无关文件
Composer 2 默认启用 autoload_static.php，-o 反而可能变慢
Composer 2 默认生成 autoload_static.php，它是预编译的轻量映射表，比旧版的 classmap 更快更省内存。此时再加 -o，反而会额外生成一个全量 autoload_classmap.php，每次请求都要完整加载和反序列化这个大数组（哪怕只用一个类），在 PHP 7.4+ + OPcache 环境下，实际性能可能下降。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
所以升级后要判断是否真需要 classmap：
- 纯 PSR-4 项目（如标准 Laravel）、类名与路径严格一一对应 → 通常不需要
-o，靠autoload_static.php+ OPcache 就够了 - 项目里混有 classmap 类型依赖（如老版本 PhpSpreadsheet、某些 WordPress 插件）、或用了大量
files加载全局函数 →-o仍有价值 - 部署环境没有 OPcache（如某些共享主机）→
-o是必要兜底
验证方式：对比 composer install --no-dev 和 composer install --no-dev --optimize-autoloader 后的 vendor/composer/ 目录结构，看是否多出 autoload_classmap.php；再测应用冷启动耗时，别只信理论
classmap-authoritative 开启前必须清理 autoload 配置
升级后若想进一步提速，考虑 --classmap-authoritative（或 -a），但它不是“更快的 autoload”，而是“更严格的 autoload”：一旦开启，Composer 彻底放弃 fallback 查找，类不在 classmap 里就直接报 Class not found，不尝试拼路径、不 file_exists()、不遍历目录。
所以开启前必须确认：
- 所有类都声明在
autoload.psr-4或autoload.classmap里，且路径真实存在 - 删掉
autoload块中无用条目，如"tests/": ["tests/"]、"docs/": ["docs/"]—— 它们会让 classmap 扫描并写入数百个无关文件 - 确保没用
autoload.files加载运行时必需的全局函数（这类文件不会进 classmap，但开了-a后仍能加载；只是容易误判为“优化失败”） - Laravel 项目注意：测试类（
Tests）必须放在autoload-dev块里，且部署时加--no-dev，否则-a会因找不到测试类而崩
最容易被忽略的是命名空间前缀的末尾反斜杠和大小写一致性——"App\": "app/" 和 "App": "app/" 在 classmap 生成阶段行为完全不同，后者几乎不会扫到任何类
