Class not found 的主因是未执行 composer dump-autoload -o；默认模式不扫描磁盘文件，新增/移动类或改命名空间后必须加 -o 重建 classmap，且生产环境应配合 --classmap-authoritative 锁死路径。
Class not found 却找不到原因？先看是不是没加 -o
遇到 Class "AppServicesPaymentService" not found，但类文件明明存在、命名空间也对——大概率是 composer dump-autoload 没走优化模式。默认不加参数只更新 PSR-4 映射路径配置（比如 vendor/composer/autoload_psr4.php），**完全不扫描磁盘上的 .php 文件**，也就不会把新类写进 autoload_classmap.php。
- 新增类、移动类文件（如从
src/Models/User.php改到src/Domain/User.php）、改了命名空间但没改composer.json→ 必须加-o -
composer install或update通常会自动触发 autoload 重建，但如果你用了--no-autoloader或 CI 流水线里先install --no-dev再合入 dev 类，就得手动补上dump-autoload -o - 验证是否生效：运行
php -r "require 'vendor/autoload.php'; var_dump(class_exists('App\Services\PaymentService'));"
dev 环境测试类加载失败？记得带上 --dev
autoload-dev 下的配置（比如 "Tests\": "tests/" 或全局 files 列表）默认不参与生产构建。不加 --dev，dump-autoload 就直接忽略这些配置，导致 TestsTestCase 找不到、辅助函数不加载。
-
composer dump-autoload --dev：包含autoload-dev配置，适合本地开发和跑测试 -
composer dump-autoload -o --no-dev：生成精简 classmap，排除tests/和vendor/bin相关类，减小体积，适合部署 - 注意：
--dev和-o可共存，但-o会跳过files加载项（如"src/helpers.php"），这是设计行为，不是 bug
生产环境部署后类仍加载错？用 --classmap-authoritative 锁死查找路径
加了 -o 后，Composer 会生成完整 classmap，但默认仍保留 fallback 机制：如果 classmap 里没找到某个类，它会退回到文件系统扫描（PSR-4 规则匹配）。这个 fallback 在生产环境是隐患——可能意外加载到旧版本或错误路径下的同名类。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer dump-autoload -o --classmap-authoritative：告诉 autoloader “所有合法类都在 classmap 里”，找不到就直接报错，不试探、不猜测 - 配合
--no-dev使用更安全：composer dump-autoload -o --classmap-authoritative --no-dev - 上线前建议检查
vendor/composer/autoload_classmap.php，确认关键类名已出现在数组中
为什么 composer update 有时不刷新 autoload？
很多人以为改完 composer.json 里的 autoload 段就只要 update，其实 Composer 会根据 composer.lock 和缓存判断是否需要重装依赖；**如果依赖版本没变，它可能跳过 autoload 重建步骤**，尤其在 CI 中启用了 --lock 或本地有较新的缓存时。
- 最稳的做法：改完 autoload 配置后，明确执行
composer dump-autoload -o，不依赖 install/update 的副作用 - 误删了
vendor/autoload.php？别重装 vendor，composer dump-autoload会原样重建它 - IDE 提示类不存在但命令行能跑？可能是 IDE 缓存滞后，或你本地用了
--no-dev而 IDE 加载了测试类 —— 先统一执行一遍composer dump-autoload --dev
真正容易被忽略的点是：classmap 不是“实时监听”，而是快照。你改了代码、挪了文件、甚至改了 composer.json，只要没跑 dump-autoload -o，那个快照就还是旧的。它不报错，也不警告，只是默默按老地图找路——直到你撞上 Class not found。
