Composer自动加载生效需同时满足：引入vendor/autoload.php、生成映射表、路径/命名空间/文件位置三者严格对齐；PSR-4是字符串替换，末尾斜杠、类名与文件名一致、运行dump-autoload缺一不可。
Composer 自动加载不是配完就能用，必须让 vendor/autoload.php 被引入、映射表被生成、路径与命名空间三者咬死对齐，缺一不可。
PSR-4 映射为什么总报 Class not found
最常见原因不是写错了配置，而是路径、命名空间、文件位置三者没对齐。PSR-4 是纯字符串替换：砍掉前缀后，剩余部分直接转成路径拼到目录后。
-
composer.json里写了"App\": "src/"，那AppHttpControllerHome就必须落在src/Http/Controller/Home.php；如果类文件实际在src/Controllers/Home.php，但 namespace 还是AppHttpControllerHome，就必然失败 - 目录末尾必须带斜杠：
"App\": "src/"对，"App\": "src"或"App\": "/src/"都错 - 文件名必须严格等于类名 +
.php：类叫UserRepository，文件就必须是UserRepository.php，user_repository.php或userRepository.php都不认 - 改了类的 namespace 或移动了文件位置，不运行
composer dump-autoload，vendor/composer/autoload_psr4.php里还是旧映射，自然找不到
classmap 和 files 该在什么场景用
别为了“统一用 PSR-4”硬套所有情况，不同机制解决不同问题。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
classmap适合无命名空间的老代码、类名和文件名不一致、或目录结构混乱又不想重构的场景；它靠扫描物理路径生成全量映射，新增类后必须重跑composer dump-autoload，否则不会加载 -
files只能用于纯函数/常量文件（如src/helpers.php），不能放 class；它会在每次引入vendor/autoload.php时无条件require_once，多个文件按数组顺序加载，注意函数重复定义风险 - 把类文件误塞进
files列表，会触发Cannot declare class X, because the name is already in use错误——因为类既被files加载了一次，又被 PSR-4/classmap 再加载一次
生产环境 autoload 优化必须用 install，不是 dump-autoload
composer dump-autoload -o 在生产部署中基本无效，真正起作用的是 composer install 阶段的参数组合。
-
composer install --optimize-autoloader --no-dev是唯一推荐的上线命令：它会跳过require-dev包、扫描所有 PSR-4/classmap 路径生成autoload_classmap.php、并剔除autoload-dev中的测试路径 -
composer dump-autoload -o不重建autoload_classmap.php，多数情况下这个文件压根不存在或内容陈旧；它只优化 PSR-4 映射为静态数组，不处理 classmap 扫描逻辑 -
--classmap-authoritative不是加速开关，而是断言模式：查不到就直接报错，不 fallback；报错说明你新加的类没进 classmap，得检查命名空间末尾反斜杠是否漏写、路径是否拼错、是否忘了加--no-dev导致测试路径干扰扫描
autoload 配置改了却没生效？先看这三件事
很多“不生效”问题其实跟 Composer 无关，而是执行链断在了前面。
- 入口文件（如
public/index.php）里没require_once __DIR__.'/../vendor/autoload.php';，再准的配置也白搭 -
composer.json改了 autoload，但没运行composer dump-autoload（开发）或composer install（部署），映射表就是旧的 - 项目是库（library）而非应用（application），根目录下误放了
vendor/，或者composer.json没放在项目根目录——Composer 只认当前工作目录下的composer.json，不会向上查找
真正容易被忽略的是：autoload 配置只影响映射表生成，不控制文件是否存在、不校验命名空间声明是否合法、也不保证 vendor/autoload.php 被引入。这三个环节任何一个断开，都会表现为“Class not found”，但原因完全不同。
