psr-4自动加载能取代手动require，但需命名空间、路径、composer.json三者严丝合缝：autoload必须为顶层键，命名空间末尾双反斜杠（如"app"），路径以"/"结尾（如"src/"），修改后须运行composer dump-autoload。
PSR-4 自动加载能彻底取代手动 require，但前提是命名空间、物理路径、composer.json 三者严丝合缝——差一个反斜杠、多一层目录、少一次 dump-autoload，Class not found 就立刻报给你看。
composer.json 的 autoload 配置为什么总不生效？
autoload 不是嵌套在其他字段里的可选配置，它必须是 composer.json 的顶层键，和 require 并列。常见失效原因：
-
autoload键名拼错（比如写成autoloader或auto-load），Composer 直接忽略 - 命名空间前缀末尾漏掉反斜杠：
"App"✅，"App"❌，"App\"在 JSON 中才是合法字面量写法 - 路径值没加结尾斜杠：
"src"❌，"src/"✅；路径必须是相对于composer.json所在目录的子路径，不支持../src/或绝对路径 - 把
autoload写在require或scripts里面，配置完全不读取
类文件放对位置却还是找不到？检查这三处硬性对齐
PSR-4 不扫描文件，只做字符串拼接。给定类名 AppHttpControllersHomeController，它会机械地拼出 src/Http/Controllers/HomeController.php —— 所以必须确保：
- 类文件真实存在于该路径，且大小写完全一致（Linux/macOS 下
Http≠http） - 文件内第一行
namespace声明完整无空格：namespace AppHttpControllers;✅，namespace AppHttpControllers ;❌ - 文件名 = 类名 +
.php：class HomeController→ 必须叫HomeController.php，不是homecontroller.php或Controller.php
迁移时最隐蔽的坑：残留的 require_once
自动加载和手动 require 混用会直接触发 Fatal error: Cannot declare class XXX because the name is already in use。迁移核心动作不是“加配置”，而是“删代码”：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 逐个删除所有显式加载类文件的
require/include（包括require_once），只保留require 'vendor/autoload.php';这一行 - 特别检查
tests/、bin/、public/index.php等非主逻辑脚本，这些地方最容易藏匿未被发现的require 'src/Utils.php' - 删完后若报
Class not found，说明该类没进 autoload：要么路径与命名空间不匹配，要么没运行composer dump-autoload，要么类名大小写拼错了
改完配置后为什么还是不加载？
vendor/autoload.php 只是个入口，真正起作用的是 vendor/composer/autoload_psr4.php —— 它不会自动更新。每次修改 composer.json 中的 autoload，或新增类文件，都必须手动执行：
composer dump-autoload
开发调试阶段别加 -o（--optimize-autoloader），因为优化后的 classmap 会覆盖 PSR-4 规则，掩盖路径映射问题；等确认规则稳定后再加。
真正卡住人的，往往不是 autoload 怎么配，而是某个 require_once 躲在第 17 个子命令脚本里没被发现——自动加载生效的前提，是整个调用链路中没有任何一处抢先用 require 把类定义了。
