类找不到的根本原因是autoload.php虽被引入，但其映射的命名空间或路径与代码不匹配；需验证路径是否正确、composer.json autoload配置是否生效、psr-4前缀与文件namespace是否严格一致，并执行composer dump-autoload -o强制刷新映射。
autoload.php 被引入但类还是找不到
这不是 Composer 没生效，而是 vendor/autoload.php 被加载了，但里面映射的路径或命名空间根本没对上你的代码。最直接验证方式是：在入口文件（如 index.php）顶部加一行 var_dump(__DIR__ . '/vendor/autoload.php');，确认路径是否指向你当前项目下的 vendor 目录；再用 php -r "require 'vendor/autoload.php';" 看是否报错——不报错但类仍找不到，问题一定出在 autoload 映射本身。
composer dump-autoload -v 输出里压根没你的命名空间
运行 composer dump-autoload -v 时，它会逐行打印扫描了哪些目录、匹配了哪些 PSR-4 前缀、跳过了哪些文件。如果你的命名空间（比如 "App"）完全没出现在输出里，说明 composer.json 的 autoload 配置根本没被读取：
-
composer.json格式错误：漏逗号、多逗号、用了中文引号、末尾多了一个逗号 - PSR-4 键值写成
"App": "src/"（缺末尾反斜杠），正确必须是"App\": "src/"或"App": "src/" - 路径用了相对写法如
"./src/"或../app/，Composer 只认相对于composer.json所在目录的真实路径 - 该命名空间被写在了
autoload-dev下，而你执行的是非开发环境命令（如没加--dev）
vendor/composer/autoload_psr4.php 里有前缀但类名还是加载失败
打开 vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如 "App"），确认它映射到的物理路径是你预期的绝对路径（比如 /var/www/myproject/src/）。再打开 vendor/composer/autoload_classmap.php，搜你要用的类全名（如 "AppControllersHomeController"），看对应路径是否存在、拼写是否一致（注意大小写、/ 方向、空格）。常见翻车点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- PHP 文件里声明的是
namespace Utils;，但 autoload 配置写的是"App": "src/"→ 完全不匹配 - 配置了
"MyApp": "app/"，但类文件实际在app/MyApp/Http/Controllers/HomeController.php→ PSR-4 会截掉前缀后拼Http/Controllers/HomeController.php，结果去找app/Http/Controllers/HomeController.php，路径断层 - 类文件含 BOM、短标签未开启、语法错误，
dump-autoload -v会在报错前卡在那个文件上，直接告诉你哪一行 parse error
多个项目共用 vendor 或 COMPOSER_VENDOR_DIR 环境变量残留
ThinkPHP、Laravel 等框架项目若共享 vendor 目录，vendor/autoload.php 里的 __DIR__ 会硬编码为第一个生成它的项目路径，导致后续项目加载时 PSR-4 映射全部指向错误目录。验证方法：
- 执行
php -r "echo require_once 'vendor/autoload.php';"，返回1但页面仍报错 → autoload.php 能加载，但映射失效 - 检查
vendor/composer/autoload_psr4.php中"think"对应的路径是否为["vendor/topthink/framework/src/"]，如果不是，说明该vendor不属于当前项目 - 运行
env | grep COMPOSER_VENDOR_DIR，如果输出非空，立刻删除该环境变量——这是跨项目污染的根源
修复必须逐项目操作：删掉当前目录下的 vendor/ 和 composer.lock，确保 composer.json 正确，再执行 composer install --no-dev --optimize-autoloader，最后强制重写映射：composer dump-autoload -o。别跳过这一步，旧缓存可能还在 vendor/composer/ 下残留。
