自动加载不生效的主因是autoload映射未更新或vendor/autoload.php未被require。需运行composer dump-autoload -v验证扫描结果，并确保入口文件首行正确引入__dir__ . '/vendor/autoload.php'。
自动加载不生效，90% 不是 Composer 坏了，而是 autoload 映射没更新、没覆盖到、或根本没被加载。 直接跑 composer dump-autoload -v 看它到底扫了什么，比猜配置快十倍。
vendor/autoload.php 没被 require 就等于没 autoload
再准的映射也救不了没引入的 autoloader。ThinkPHP、Laravel 或自写入口，第一行必须是：require __DIR__ . '/vendor/autoload.php';。不是 ../vendor/autoload.php，也不是 ./vendor/autoload.php，__DIR__ 是唯一可靠起点。
- 用
file_exists(__DIR__ . '/vendor/autoload.php')手动验证，别信 IDE 自动补全 - CLI 脚本最容易漏——哪怕
composer dump-autoload -v成功，没require就白搭 - Web 环境下报 500 或空白页？立刻查错误日志里有没有
failed to open stream: No such file
composer dump-autoload -v 输出里压根没你的命名空间
这说明 composer.json 的 autoload 段根本没被识别。JSON 格式错一个字符（比如少逗号、多逗号、中文引号、缩进混乱），整个块就静默失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查键名是不是拼成
"autoloader"或"autoloads"—— 正确是"autoload" - PSR-4 命名空间前缀必须以双反斜杠结尾：
"app\": "app/"✅，"app": "app/"❌（后者会导致路径推导多截一层） - 路径值末尾加不加
/不影响，但必须和实际目录结构一致；写成"./app/"或"../src/"会被忽略 - 执行
composer dump-autoload -v后，终端应出现类似Scanning /path/to/project/app/ for namespace app\的行 —— 没这行，就是配置没生效
映射生成了，但类还是找不到
先看 vendor/composer/autoload_psr4.php 里有没有你的命名空间条目，再确认右边路径是否指向真实目录。别信配置，看生成结果。
- 打开
autoload_psr4.php，搜索"app\"（注意双反斜杠），确认值是["/path/to/project/app/"]而不是["/path/to/project/src/"] - 类
appcontrollerIndex必须在app/controller/Index.php，大小写必须完全一致（Linux 下Index.php≠index.php） - 新增类后必须手动运行
composer dump-autoload—— Composer 不监听文件变化，install或update不会触发重生成，除非锁文件变动 - 删过
vendor/composer/autoload_*.php？直接rm -f vendor/composer/autoload_*.php再跑dump-autoload -v，避免旧缓存干扰
镜像源不影响 autoload，但会影响 vendor 目录完整性
换阿里云、腾讯云或华为镜像，只加速包下载，不改变 autoload 行为。但镜像配置错误或网络中断，可能导致 vendor/autoload.php 缺失或 vendor/composer/ 下文件不全。
- 部署时用
composer install --no-dev，确保autoload.php和autoload_psr4.php都存在 - Docker 或 rsync 同步时，检查
.gitignore是否误删了vendor/composer/autoload_*.php - CI/CD 脚本里漏掉
composer dump-autoload是高频翻车点，建议显式加入部署流程
最常被忽略的是：改完 composer.json 后只跑了 composer install，却没跑 dump-autoload；或者以为 vendor/autoload.php 是“自动存在的”，忘了它必须被 require 才生效。这两步缺一不可。
