结论：90%的“类无法自动加载”源于autoload未触发、未生效或路径未被composer扫描；必须用composer require安装、autoload须为composer.json顶层字段、命名空间末尾双反斜杠不可少、路径严格匹配且大小写敏感、引入vendor/autoload.php须用__dir__绝对定位。
直接说结论：90% 的“安装后类无法自动加载”，不是包有问题，而是 autoload 没触发、没生效，或映射路径根本没进 Composer 的扫描范围。
composer require 用对了吗？别手动扔文件
手动下载 ZIP、git clone 到 vendor/ 目录下，vendor/autoload.php 是完全无视它的——Composer 只认自己写进 vendor/composer/autoload_psr4.php 的映射。
- 必须用
composer require vendor/package安装，而不是复制粘贴 - 第三方包若声明了
autoload字段（运行composer show vendor/package查看），才会被纳入自动加载体系 - 纯函数库（如某些工具包）可能只用
files类型 autoload，这类文件会在每次请求时include_once，不靠命名空间发现，得靠composer dump-autoload生成包含逻辑
PSR-4 映射写在哪儿？位置错就等于没写
autoload 必须定义在项目根目录 composer.json 的顶层字段，不是 autoload-dev，也不是塞进 extra 或 scripts 里。JSON 格式错一个逗号、多一个空格、混入中文标点或零宽字符，整个 autoload 块都会被静默跳过。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确结构：
"autoload": { "psr-4": { "App\": "src/" } }—— 注意App\结尾双反斜杠是必需的 - 路径值不能以斜杠结尾：
"src/"✅，"src/"❌（某些版本会忽略） - 改完立刻执行
composer dump-autoload，composer install不会重生成 autoload 映射
类文件路径和命名空间真匹配吗？大小写就是硬规则
PSR-4 不是模糊匹配，它按规则拼路径：AppHttpControllersHomeController → src/Http/Controllers/HomeController.php。Linux/macOS 下大小写敏感，Windows 可能掩盖问题，但上线必炸。
- 命名空间前缀必须和
composer.json中声明的完全一致（包括大小写、反斜杠数量） - 文件名必须与类名严格一致：
HomeController.php内必须是class HomeController，不能是homecontroller或HomeController2 - 目录结构必须逐级对应：
AppFooBar就得是src/Foo/Bar.php，不能是src/app/Foo/Bar.php（多了一层app/）
autoload.php 引入对了吗？路径依赖当前工作目录就是坑
入口脚本（index.php、CLI 脚本）顶部必须有且仅有一行有效引入：require __DIR__ . '/vendor/autoload.php';。用相对路径 'vendor/autoload.php' 或 ../vendor/autoload.php 在不同执行环境（Web / CLI / Docker）下极易失效。
-
__DIR__是唯一安全的基准，它指向当前脚本所在目录，不随getcwd()变化 - 确认引入时机：必须在任何类使用之前，且不能被条件语句包裹（比如写在
if (false) { }里） - 加一行验证：
var_dump(file_exists(__DIR__ . '/vendor/autoload.php'));，输出true才算真正加载成功
最常被忽略的其实是 vendor/composer/autoload_psr4.php 这个文件——它才是自动加载的最终执行依据。打开它，搜索你的命名空间前缀，看映射路径是否是你预期的绝对路径；再搜具体类名，确认是否出现在 autoload_classmap.php 中。一切调试，都该从这里开始，而不是猜。
