Composer autoload 找不到文件主因是配置未生效或路径映射错误；需确保 composer.json 中 PSR-4 路径相对于根目录且不带 ./，类名与文件路径严格匹配，并显式运行 composer dump-autoload。
Composer autoload 找不到文件，绝大多数情况是 autoload 配置没生效或路径映射错误，而不是 Composer 本身坏了。
检查 composer.json 中的 autoload 配置是否写对了
常见错误是路径写成相对当前目录（比如 ./src），但 Composer 要求的是相对于 composer.json 所在根目录的路径 —— 而且不能带 ./ 前缀。
-
"psr-4": { "App\": "src/" }✅ 正确（末尾斜杠可选，但推荐加） -
"psr-4": { "App\": "./src" }❌ 错误（./会被忽略，src可能被当成子目录名） -
"psr-4": { "App\": "src" }⚠️ 看似对，但若src下无命名空间对应子目录（如src/Controller/对应AppController），类仍会加载失败 - 用
classmap时，路径必须指向实际含class定义的 PHP 文件，或包含它们的目录（Composer 会扫描并生成映射）
运行 composer dump-autoload 后仍不生效？先确认 autoloader 是否被引入
即使配置正确、生成了 vendor/autoload.php，如果代码里没 require 它，或者用了旧的 require 路径，类照样找不到。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确保入口文件（如
index.php）第一行是：require __DIR__ . '/vendor/autoload.php'; - 不要写成
require 'vendor/autoload.php'—— 相对路径易因工作目录变化失效 - 检查是否误删或覆盖了
vendor/autoload.php（比如 git 忽略了vendor/，部署时没运行composer install） - 运行
composer show --platform可快速验证 autoloader 是否已加载（它依赖vendor/autoload.php）
类名与文件路径不匹配：PSR-4 最容易翻车的地方
PSR-4 不是“自动猜路径”，而是严格按命名空间 + 目录前缀拼接。比如配置 "App\": "src/"，那么 AppControllerHomeController 必须存在于 src/Controller/HomeController.php。
- 文件名大小写必须和类名完全一致（Linux/macOS 区分大小写，Windows 下可能掩盖问题）
-
src/Controller/homecontroller.php→ 即使类名是HomeController，也会加载失败 - 命名空间末尾没加反斜杠（如写成
"App"而非"App\"）会导致子命名空间（如AppConsole）不被识别 - 用
composer dump-autoload -o生成优化后映射时，不会校验文件是否存在 —— 错误配置会静默跳过，建议开发期先不用-o
调试 autoload 失败的具体原因
别只看 “Class not found”，用 Composer 自带工具定位真实瓶颈：
- 执行
composer dump-autoload -vvv，观察控制台输出是否列出了你期望的命名空间和路径 - 临时在
vendor/composer/autoload_psr4.php里加var_dump($psr4)，确认映射数组是否包含你的配置项 - 用
composer show -p查看已加载的平台包，排除因冲突导致 autoloader 被覆盖的可能 - 如果类在
vendor/里（比如第三方包），确认该包自身autoload配置合法，且未被replace或conflict规则屏蔽
最常被忽略的一点：修改 composer.json 后，composer install 不会重新生成 autoload 映射，必须显式运行 composer dump-autoload（或 composer update）—— 这个动作不是“可选优化”，而是强制触发步骤。
