composer自动加载依赖vendor/autoload.php注册的spl_autoload_register()及预生成映射表；改composer.json后必须执行composer dump-autoload，否则配置不生效。

Composer 自动加载不是“写个函数就能跑”，而是靠 vendor/autoload.php 注册的 spl_autoload_register() 回调 + 预生成的映射表协同工作；改了 composer.json 不执行 composer dump-autoload，等于没改。

PSR-4 映射为什么必须带结尾反斜杠和斜杠？

PSR-4 规则里，"App\": "src/" 中的 \ 和 / 都不是可选符号，是路径拼接的分界锚点：

• namespace AppController; + class UserController → 拼出相对路径 Controller/UserController.php，再拼到 src/ 后变成 src/Controller/UserController.php
• 如果写成 "App": "src"（缺末尾 /），就会拼成 srcController/UserController.php，直接 404
• 如果写成 "App\": "src"（路径缺 /），结果一样错；写成 "App": "src/"（命名空间缺 \），则 AppController 会被当作顶层命名空间，找不到 src/Controller/ 子目录
• Linux 下大小写敏感：文件名是 UserController.php，但类定义写成 class usercontroller 或 class UserController 在文件里却叫 usercontroller.php，都会失败

为什么改了 composer.json 还是 Class not found？

常见原因不是代码写错，而是自动加载链断在了中间环节：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 没在入口文件（如 index.php）里 require 'vendor/autoload.php' —— 这是整个机制的起点，漏掉就全失效
• 改了 composer.json 的 psr-4 配置但没运行 composer dump-autoload —— vendor/autoload.php 不会自动重读配置，它只加载 vendor/composer/autoload_psr4.php 里的静态映射
• 手动修改过 vendor/composer/autoload_psr4.php —— 这个文件是生成的，下次 dump-autoload 会被覆盖，手改等于白干
• 用了 --no-scripts 或 CI 环境跳过了 autoload 生成步骤 —— 查看 vendor/composer/ 下是否存在 autoload_psr4.php 文件

classmap 和 PSR-4 混用时要注意什么？

classmap 是暴力扫描型加载，不依赖命名空间或文件结构，但代价是构建慢、更新不及时：

• classmap 路径配置写的是目录（如 "lib/"），Composer 会递归扫描所有 .php 文件，用正则提取 class、interface、trait 名字并记录绝对路径
• 它和 PSR-4 共存时，优先级由 ClassLoader 内部决定：先查 PSR-4 前缀匹配，再 fallback 到 classmap 全局查表
• 如果一个类既符合 PSR-4 规则又被扫进 classmap，PSR-4 仍优先生效；但 classmap 里的类一旦被移动或删文件，dump-autoload 不重新跑就不会更新映射，容易“加载旧文件”
• 用 composer dump-autoload --optimize 会把所有映射合并进 autoload_classmap.php，提升性能，但开发期调试建议不用，否则改了类也得强制重 dump

最常被忽略的一点：自动加载生效的前提，是你根本没手动 require_once 'src/xxx.php'。一旦这么干，就绕过了 Composer 的依赖图和版本隔离逻辑——特别是当你升级某个包，它的内部类路径变了，而你的硬引用还钉在旧位置，问题就藏得特别深。