Class not found主因是自动加载映射未生效或路径不匹配：需运行composer dump-autoload -o重建映射，检查autoload_psr4.php中命名空间与src/等路径是否一致，并确认类名、命名空间、文件路径及大小写严格符合PSR-4规范。
“Class not found”不是包没装上，而是自动加载映射没生效或路径没对齐——90% 的问题靠 composer dump-autoload -o + 检查 autoload_psr4.php 就能解决。
为什么 composer install 后类还是找不到
根本原因不是依赖没下载，而是 Composer 没把新类写进自动加载映射表。常见于：手动删过 vendor/、切换 Git 分支后没刷新 autoload、用 composer install --no-autoloader 跳过生成、或改了 composer.json 的 autoload 配置但忘了重跑命令。
- 运行
composer dump-autoload -o强制重建优化版映射（-o不可省，否则不扫描新目录） - 检查
vendor/composer/autoload_psr4.php里有没有你的命名空间，例如'App\' => array($baseDir . '/src') - 确认类文件路径和命名空间完全匹配：比如
AppServiceUserService必须在src/Service/UserService.php，且文件名大小写一致 - 别信 IDE 自动补全的
use—— 手动检查是否拼错命名空间，比如漏了末尾反斜杠App
新增包后 Class not found 怎么快速修复
很多人用 composer install 或直接 git clone 到 vendor/，结果类就是不认。这不是权限或网络问题，是 Composer 根本没把它纳入自动加载流程。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须用
composer require vendor/package-name安装新包，它会同时写composer.json、下包、并触发dump-autoload - 如果已手动放好包，先删掉
vendor/vendor/package-name，再跑composer require补全元数据 - 检查该包自己的
composer.json是否声明了autoload（如psr-4映射），有些小众包漏配会导致整个命名空间不被扫描 - 临时验证：在代码里加一句
var_dump(class_exists('Vendor\Package\SomeClass'));，返回false就说明 autoload 没生效，不是代码问题
报错说某个方法不存在（Call to undefined method）
这通常是依赖升级导致的 API 断裂，不是 autoload 问题。Composer 不会警告你某个方法被删了，只会在运行时崩。
- 先用
composer show vendor/package-name确认实际安装版本，别只看composer.json里的约束 - 对比
composer.lock升级前后的version和source.reference字段，commit hash 变了就说明代码真不一样了 - 查该包的 GitHub Release 页面，重点看 CHANGELOG 或直接
git diff v1.2.3 v1.3.0 src/ClassName.php看方法是否被移除 - 运行时验证：加一行
var_dump(method_exists(ClassName::class, 'brokenMethod'));，排除缓存干扰
Linux/macOS 下 ext-* 缺失但 php -m 显示已加载
CLI 和 Web SAPI 用的不是同一份 php.ini，而 Composer 只看 CLI 环境。你以为启用了，其实它根本没读到。
- 执行
php --ini，看Loaded Configuration File路径，去那里改配置，不是/etc/php.ini就是/usr/local/etc/php/8.2/php.ini - Ubuntu/Debian 用户注意：PHP 8.2 就得装
php8.2-intl，装php-intl是无效的 - macOS Homebrew 用户：装完
php@8.2-intl后，php.ini里不会自动加extension="intl"，必须手动补上 - Windows 用户：确认
extension_dir指向的目录下真有php_intl.dll，且php.ini里是extension=php_intl.dll（不是extension=intl）
最常被跳过的一步是：改完 php.ini 后没验证 php -m | grep intl 是否真出现。别假设它生效了，每次都要亲手确认。
