class not found 根源在于 psr-4 映射路径与实际 namespace 或文件位置不匹配，需检查 composer.json 路径、文件 namespace 声明、避免 psr-4 与 classmap 混用冲突，并执行 composer dump-autoload -o 刷新 autoload 文件。
composer dump-autoload 报 Class not found 怎么定位根源
类找不到，90% 不是 Composer 本身坏了，而是 psr-4 映射和实际 namespace 声明对不上。比如你在 app/Helpers/Str.php 里写了 namespace AppHelpers;，但 composer.json 中却配成："App\": "src/"——路径错位，Composer 根本不会去 app/ 下扫描。
快速验证方式：
- 运行
composer dump-autoload -v，看输出里是否列出你期望的类路径（如AppHelpersStr） - 用
grep -r "namespace App\\Helpers" app/确认文件中 namespace 是否带双反斜杠（PHP 字符串转义后应为AppHelpers） - 检查路径是否为相对路径：若
composer.json在项目根目录，"App\": "app/"是对的，"App\": "/app/"或"App\": "app"（缺末尾斜杠）都可能在某些系统下失效
PSR-4 和 classmap 混用导致 autoload 失效
一个常见误操作：既在 psr-4 里声明了 "MyLib\": "lib/"，又在 classmap 里加了 "lib/Utils.php"。结果是 Utils.php 若没写 namespace MyLib;，PSR-4 规则直接跳过它；而 classmap 又被 PSR-4 优先级覆盖，导致文件“两头不靠”。
判断依据：
-
psr-4是命名空间驱动：只认namespace+ 目录结构，不关心文件名 -
classmap是路径驱动：直接映射类名到文件，适合无命名空间的老代码 - 同一类名不能同时出现在两种规则中，否则行为未定义，Composer 默认以
psr-4为准 - 混用时务必确认：所有
classmap中的文件，其类名必须与文件路径严格对应（如lib/Utils.php必须含class Utils）
改完 autoload 配置后仍不生效
不是配置没写对，而是没走通生成链。Composer 不会自动监听 composer.json 变更，必须手动触发重建。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须执行的步骤：
- 每次修改
autoload后，**立刻运行**composer dump-autoload -o（-o强制生成优化后的classmap，跳过运行时扫描） - 如果部署环境用 CI 构建，确保构建脚本里包含这一步，不能只依赖本地开发机执行
- 怀疑缓存残留？删掉
vendor/composer/autoload_*.php全部文件，再跑dump-autoload -o，比反复重试更彻底 - 生产环境建议加
--no-dev：避免autoload-dev干扰，尤其当测试类和主逻辑共用命名空间时
ThinkPHP/Laravel 等框架特有的 autoload 冲突点
框架自带的自动加载机制和 Composer 并存时，容易互相覆盖或重复注册。例如 Laravel 10 启用 PSR-4 自动发现后，若你还在 composer.json 里显式写："App\Providers\": "app/Providers/"，会导致 AppServiceProvider 被加载两次或根本找不到。
关键适配动作：
- Laravel 10+：只保留
"App\": "app/"，删掉所有子目录映射（如Providers、Models），让框架自动发现 - ThinkPHP 6：若自定义了
extend/目录，必须在composer.json的autoload中声明，且路径值要和 TP 的ROOT_PATH . 'extend/'一致 - CodeIgniter 3：确认
$config['composer_autoload']开启，且APPPATH . 'vendor/autoload.php'存在；不要同时用__autoload或spl_autoload_register手动注册相同命名空间 - 所有框架：避免在入口文件或控制器里
require_once 'vendor/autoload.php'—— 应由框架自身控制加载时机
最常被忽略的一点：autoload 冲突往往不是“找不到类”，而是“找到两个同名类”。一旦发生，PHP 会直接 fatal error，但错误信息里不提示冲突来源。这时候得翻 vendor/composer/autoload_psr4.php 和 autoload_classmap.php，看同一个类名是否出现在多个映射条目中。
