autoload不生效主因是vendor/autoload.php未被require或PSR-4路径与命名空间不匹配；需检查入口文件是否用__DIR__绝对路径引入，确认命名空间、目录结构、大小写严格一致，并排除权限与缓存问题。
autoload 不生效，90% 的情况不是配置写错了，而是 vendor/autoload.php 根本没被 require，或者类路径和命名空间对不上——先盯住这两点，多数问题当场消失。
入口文件漏了 require vendor/autoload.php
Composer 只生成自动加载逻辑，不自动执行它。哪怕 composer dump-autoload 成功，没在脚本顶部 require 就等于没加载。
- 检查你的入口文件（如
index.php、cli.php或测试脚本）第一行是否写了：require __DIR__ . '/vendor/autoload.php'; - 框架项目（Laravel/Symfony）也要确认没误删这行；有些模板会把这行注释掉或挪到条件判断里
- CLI 脚本最容易漏——它不走 Web 入口，必须单独加
require - 别用相对路径如
require 'vendor/autoload.php'，当前工作目录一变就失效；一律用__DIR__绝对定位
PSR-4 命名空间与文件路径不匹配
PSR-4 不是“猜路径”，它靠严格字符串匹配：命名空间前缀 + 目录路径 + 类名 = 文件路径。错一个字符、大小写、斜杠方向，就加载失败。
-
"App\": "src/"表示AppFooBar类必须对应src/Foo/Bar.php，且文件内必须有namespace AppFoo; - 路径末尾不能多写
/（如"src//"），某些 Composer 版本会静默忽略 - Linux/macOS 区分大小写：
src/Models/user.php无法加载AppModelsUser，类名和文件名都得大驼峰 - 运行
composer dump-autoload -v，看输出里有没有No files found for...——有就说明路径声明了但没扫到文件
autoload.files 里的函数死活找不到
autoload.files 是最安静的失败场景：不报错、不警告，函数就是没定义。根本原因是它在 autoloader 初始化阶段就执行，此时其他类还没加载。
立即学习“PHP免费学习笔记（深入）”；
- 路径必须是相对于
composer.json所在目录的**相对路径**（不是当前脚本路径，也不是vendor/下） - 文件里不能直接调用未加载的类，比如
Str::slug()—— 这会导致Fatal error，且 autoload 中断，后续函数全失效 - 不要在该文件里做
new实例化或依赖注入，只放纯函数定义 - 安全做法：把函数封装进一个带存在性检查的引导函数里，等真正需要时再加载，而不是靠
autoload.files一次性全拉进来
缓存残留或 vendor 权限污染
旧的 classmap 缓存、root 用户残留的 vendor/ 权限、Docker/NFS 文件系统事件丢失，都会让 autoload 看似配置正确却不动。
- 运行
ls -ld vendor/，如果显示root root，立刻执行：sudo chown -R $USER:$USER vendor/ - 删掉
vendor/composer/整个目录，再跑composer dump-autoload，比修单个文件更可靠 - Docker 环境下，
composer watch类工具可能不触发重载，改完代码后手动composer dump-autoload - CI/CD 流程中避免
chmod -R 777 vendor/—— 它会让 Git 忽略权限变更，还会导致可执行文件被拒收
真正难排查的从来不是配置语法，而是路径、权限、加载时机这三个隐性层叠；尤其当本地能跑、部署就挂时，优先查 vendor/ 归属和 autoload.files 里的类依赖链。
