结论：唯一正确生成自动加载文件的方式是 composer dump-autoload——它仅重写 vendor/autoload.php 及相关映射文件，不安装包、不修改 vendor/ 和 composer.lock。
直接说结论：用 composer dump-autoload 就是“只生成自动加载文件”的唯一正确方式——它不装包、不改 vendor/、不碰 composer.lock，纯粹重写 vendor/autoload.php 及其背后的映射文件。
为什么不能用 install 或 update 替代 dump-autoload
很多人误以为跑 composer install 就能“修好自动加载”，其实只是碰巧触发了副作用。它本质是重装依赖：清空 vendor/、重新解压包、再顺带 dump 一次。CI/CD 里这么干，等于每次构建都浪费数秒 I/O 和内存；本地开发时还可能覆盖你手动改过的第三方代码。
真正只动 autoload 的命令只有：composer dump-autoload。它只读取当前 composer.json 的 autoload 字段，重写 vendor/composer/autoload_psr4.php、autoload_classmap.php（需条件）、autoload_static.php 等，其余一概不动。
dump-autoload 后还是 Class not found？先查这三处硬性配置
命令执行成功 ≠ 类能加载。90% 的问题出在 composer.json 的 autoload 配置本身：
-
"autoload"必须是顶层字段，不能塞在require或scripts里 - PSR-4 命名空间末尾必须带双反斜杠：
"App\": "src/"✅，"App": "src/"或"App\ "（多空格）❌ - 路径值必须是项目根目录下的相对路径：
"src/"✅，"./src/"、"../src/"、/var/www/src/❌ - 类文件名必须与类名严格一致（大小写敏感）：
UserRepository.php→class UserRepository，userrepository.php在 Linux 下直接失效
什么时候必须加 -o 参数
composer dump-autoload 默认只更新 PSR-4/PSR-0 的路径映射，**完全不扫描磁盘上的 PHP 文件**。也就是说，你新增了 src/Utils/Helper.php，但没加 -o，new AppUtilsHelper() 一定报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须加 -o（即 --optimize）的场景：
- 新增、移动或删除了类文件，且没同步修改
composer.json中的 PSR-4 映射 - 项目中声明了
"classmap": ["legacy/"]，但legacy/目录下已有类文件，需要全量扫描生成autoload_classmap.php - CI/CD 构建后要确保 autoload 与当前代码 100% 一致（推荐
composer dump-autoload -o --no-dev）
注意：-o 在 Composer 2.x 中默认不生成 autoload_classmap.php，除非你显式配置了 classmap 字段，或同时用了 --classmap-authoritative。
镜像源和 dump-autoload 完全无关
镜像源（如阿里云、腾讯云）只影响 composer install 或 update 时下载包的速度和地址，对 dump-autoload 没有任何作用——它不联网、不查远程、不读包内容，只处理本地 composer.json 和文件系统。
如果你在 CI 中发现 dump-autoload 失效，别怀疑镜像，去检查：
- 是否在
composer install --no-dev后才新增了 dev-only 类（比如测试类），却忘了补跑composer dump-autoload --dev - 是否用了
--classmap-authoritative，但漏扫了某些路径（比如files加载的函数文件里定义了类，这类“伪类”不会进 classmap） - PHP 扩展缺失（如
ext-intl），导致某些 polyfill 类在 autoload 阶段就失败，报错看起来像 Class not found
最易被忽略的一点：Composer 2.x 的 -o 不等于“自动加速”，它是否生成 autoload_classmap.php 完全取决于你有没有在 composer.json 里写 classmap 字段，或者是否加了 --classmap-authoritative。没配就加 -o，只是白跑一趟。
