Composer自动加载必须满足三个硬性条件：autoload为composer.json顶层字段、命名空间与路径严格对齐、每次修改后手动运行composer dump-autoload；漏任一环即Class not found且无提示。
Composer自动加载不是“配完就能用”，它必须满足三个硬性条件：composer.json里autoload是顶层字段、命名空间和路径字符串拼接规则严格对齐、每次改动后手动运行composer dump-autoload。漏掉任一环，Class not found就必然发生，且不报错、不提示。
composer.json 的 autoload 字段必须写在顶层
常见静默失效是因为把autoload塞进了extra、scripts或require里——Composer直接忽略，连警告都没有。
-
autoload必须和name、require平级，是 JSON 一级键 - 写成
"auto-load"、"autoloader"或"autoloads"都无效 - 正确示例：
{"name": "my/app","require": {...},"autoload": {"psr-4": {"App\": "src/"}}}
PSR-4 的命名空间与路径怎么对齐才不炸
PSR-4 不扫描目录，只做字符串替换：砍掉命名空间前缀，把剩余部分的全换成/，再拼上配置里的路径。差一个字符，文件就找不到。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 命名空间键必须是双反斜杠结尾：
"App\"✅，"App"❌，"App\"（开头反斜杠）❌ - 路径值必须以正斜杠结尾：
"src/"✅，"src"❌（会拼出srcMyClass.php） -
AppHttpControllersHomeController→ 剥离App\得HttpControllersHomeController→ 替换为/得Http/Controllers/HomeController.php→ 拼src/得src/Http/Controllers/HomeController.php - 文件必须真实存在，且大小写完全一致：
src/Http/Controllers/≠src/http/controllers/（Linux/macOS 下）
为什么改了配置还是 Class not found
因为真正干活的是vendor/composer/autoload_psr4.php这个生成文件，它不会监听变化，只在composer dump-autoload时重写。
- 改完
composer.json没运行composer dump-autoload→ 映射根本没进autoload_psr4.php - 运行了但
src/目录不存在 → 命令不报错，运行时才抛file not found - 入口文件里先
new AppHttpControllersHomeController()再require 'vendor/autoload.php'→ autoload 队列还没注册就触发了加载 - 调试建议：
var_dump(include 'vendor/composer/autoload_psr4.php');看数组里有没有你配的键
autoload-dev 和 classmap 的实际使用场景
测试类不能塞进主autoload.psr-4，否则部署时可能被意外加载；classmap 不走路径拼接，适合旧代码或性能敏感场景。
- 测试类应单独配
autoload-dev："autoload-dev": {"psr-4": {"Tests\": "tests/"}} -
composer install --no-dev时，Tests\映射不会写入vendor/autoload.php - 用
classmap替代 PSR-4：适用于无命名空间的老项目，或想跳过file_exists()检查的生产环境（加-o参数） -
composer dump-autoload -o生成优化版 classmap，但会掩盖路径错误，调试阶段建议先用不带-o的版本
最常被忽略的点是：vendor/autoload.php 只是启动器，真正决定“能不能加载”的是 vendor/composer/autoload_psr4.php 里的数组内容——它不会自动更新，也不校验路径是否存在，全靠你手动触发 dump-autoload 并确认输出无误。
