composer dump-autoload -o 是重新加载命名空间映射的唯一可靠方式；改 composer.json 中 autoload 配置后必须执行该命令，否则新增或移动的类即使路径、命名空间、文件名全对也无法加载。

composer dump-autoload -o 是重新加载命名空间映射的唯一可靠方式

改了 composer.json 里的 autoload 或 autoload-dev 配置后，不运行 composer dump-autoload -o，新增或移动的类就一定找不到——哪怕路径、命名空间、文件名全对，也白搭。

默认的 composer dump-autoload 只重写 PSR-4 映射表（如 vendor/composer/autoload_psr4.php），但不会扫描磁盘上新增/删改的 PHP 文件；只有加 -o 才会清空并重建 autoload_classmap.php，把所有匹配目录下的类名和路径关系重新拉一遍。

• 新增了 AppServicesNotificationService，但报 Class "AppServicesNotificationService" not found → 必须 composer dump-autoload -o
• 把 src/Models/User.php 改成 src/Domain/User.php，同时更新了 "App\": "src/" 配置 → 仍需 -o，否则旧路径还在 classmap 里缓存着
• CI 流水线中先执行 composer install --no-dev，再合入测试类，之后想让 Tests 命名空间可用 → 得补一句 composer dump-autoload -o --dev

PSR-4 命名空间前缀必须带结尾反斜杠

"App": "src/" 合法，"App" 或 "App\"（双反斜杠）都不行——前者被当成字符串字面量，后者在 JSON 中非法。漏掉这个反斜杠，Composer 不报错，但整个命名空间映射静默失效。

实际类文件位置必须严格对应：命名空间 AppHttpControllers → 目录 src/Http/Controllers/；类名 HomeController → 文件名必须是 HomeController.php，且不能是 homecontroller.php 或 HomeController.inc。

Discussion Composer

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

下载

• 路径是相对于 composer.json 所在目录的，不是项目根目录，也不是 vendor/
• 子命名空间层级必须与子目录层级完全一致，中间不能缺层，也不能多层（比如 AppHttpController 对应 src/Http/Controller，不是 src/Http/Controllers）
• Windows 下路径分隔符用正斜杠 /，不要用反斜杠 ，JSON 解析会出错

autoload-dev 的配置只在开发环境生效

autoload-dev 下的映射（如 "Tests\": "tests/"）默认不会写入生产环境的 vendor/autoload.php。如果你在 CI 中用了 --no-dev，又没手动 require 测试类，那 TestsTestCase 就必然 Class not found。

更隐蔽的问题是：有人为了图省事，把 tests/ 加进主 autoload，结果上线包里混进了测试代码，甚至某些初始化逻辑在生产环境意外触发。

• PHPUnit 默认读取 autoload-dev，所以测试类路径错，直接报错，不走 fallback
• 运行 composer dump-autoload -o --no-dev 会跳过 autoload-dev 配置，生成的 classmap 里不会有 Tests 开头的类
• 如果测试类依赖 src/ 下的类，确保主 autoload 已正确配置，否则 class_exists('TestsTestCase') 为 true，但内部 new AppServicesXxx() 仍失败

验证 autoload 是否真正生效，别只看命令是否跑完

执行完 composer dump-autoload -o，不代表类就能加载。最简验证方式是直接用 PHP 命令行测试：

php -r "require 'vendor/autoload.php'; var_dump(class_exists('App\Services\PaymentService'));"

如果返回 bool(false)，说明问题还在：要么类文件根本不在扫描路径下，要么命名空间声明和文件物理位置不匹配，要么你当前执行命令的目录不是 composer.json 所在目录。

• 检查 vendor/composer/autoload_classmap.php，搜索你的完整类名，确认它已出现在数组键中
• 确认没有启用干扰插件（如 hirak/prestissimo），可临时加 --no-plugins 重试
• IDE 缓存或文件系统索引延迟常让人误判，别信“我刚保存了”，要信 class_exists() 返回值

实际项目里，最常被忽略的是：改完 composer.json 后，人坐在电脑前等自动加载“自己生效”。它不会。连 dump-autoload 都不敲，就去跑 phpunit 或刷新页面，等于拿石头砸自己的脚。