class not found 但代码能跑，是 phpstorm 索引未同步所致；需执行 reload project from disk 或 invalidate caches and restart，并标记 vendor/autoload.php 为 php include root，同时确保 content root 和 source root 配置正确。
Class not found 但代码能跑，先别动 composer.json
这是 PhpStorm 索引没跟上文件结构的典型表现，不是 autoload 配置错了，也不是类写错了。IDE 没把 app/Models/User.php 和 AppModelsUser 关联起来，但 PHP 运行时靠 vendor/autoload.php 里的映射照样加载成功。
优先执行两步：
- 按 Ctrl + Shift + O（Windows/Linux）或 Cmd + Shift + O（macOS）触发「Reload project from disk」
- 若无效，进 File → Invalidate Caches and Restart → Invalidate and Restart
重启后等右下角出现 Indexing finished 再检查，中途看结果没意义。
vendor/autoload.php 标红？IDE 没认它为入口
即使 composer install 成功、php -r "require 'vendor/autoload.php';" 不报错，PhpStorm 也可能完全忽略这个文件——导致所有第三方类和你自己的 PSR-4 类都标红。
手动告诉 IDE 这是自动加载起点：
- 右键点击项目根目录下的 vendor/autoload.php → Mark as PHP Include Root
- 同时右键 vendor 目录 → Mark Directory as → Excluded（避免索引拖慢）
- 进 Settings → Languages & Frameworks → PHP → Composer，确认勾选了 Enable composer library detection，且 composer.json 路径指向项目根目录
PSR-4 映射对不上，IDE 推断就失效
命名空间和物理路径必须严格一致，大小写都不能错。比如 namespace AppModels; 对应的文件必须在 app/Models/User.php，不能是 App/Models/User.php 或 app/models/User.php（Linux 服务器区分大小写，IDE 默认也校验）。
检查 composer.json 中的 autoload 配置：
- "App\": "app/" 末尾的斜杠不能少，反斜杠要双写
- 执行 composer dump-autoload -o 更新映射后，必须再做一次 Invalidate Caches and Restart，否则 IDE 不会读取新生成的 vendor/composer/autoload_psr4.php
PHP 解释器或语言级别设错，底层解析就乱套
如果 IDE 用的是 PHP 7.4 的解释器，但你代码用了 mixed 类型声明（PHP 8.0+），或者命名空间嵌套用了 PHP 8.2 的新语法，静态分析就会直接放弃推导——表现为类找不到、跳转失败、类型提示全灰。
检查两处：
- Settings → Languages & Frameworks → PHP → CLI Interpreter：路径是否指向你实际运行项目的 PHP 版本（比如 WSL 里的 /usr/bin/php，不是 Windows 的 php.exe）
- Settings → Languages & Frameworks → PHP → Language level：必须和解释器版本一致，不能选高也不能选低
改完解释器或语言级别后，不重启就白改——因为 JVM 里缓存的解析上下文不会自动刷新。
真正卡住的问题，往往出在 Content Root 配置错误或 Source Root 没标记，而不是 autoload 本身。索引重建只是表象，根目录配不对，重一百次也没用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
