优先重建索引，因IDE索引滞后或损坏导致类名标红但运行正常；需依次执行Reload project、Invalidate Caches and Restart，并检查Composer autoload配置、PSR-4路径一致性及PHP语言级别与解释器设置。
PhpStorm 类名标红但运行正常，优先重建索引
这是 PhpStorm 索引滞后或损坏的典型表现，不是代码问题，而是 IDE 没把类文件纳入解析范围。别急着改 composer.json 或重写命名空间，先让索引跟上实际文件结构。
- 按
Ctrl + Shift + O（Windows/Linux）或Cmd + Shift + O（macOS）触发「Reload project from disk」，强制从磁盘重新读取项目结构 - 若仍标红，进
File → Invalidate Caches and Restart → Invalidate and Restart：这会清空.idea/php.xml和misc.xml中的索引元数据，重启后自动重建，90% 以上情况在此步解决 - 重启后等待右下角提示「Indexing finished」再检查，别在索引中途判断效果
Composer autoload 未被识别，检查 vendor 和 include root
即使 vendor/autoload.php 存在且能运行，PhpStorm 也可能没把它当作 PHP 包入口，导致第三方类或自定义包标红。
- 右键点击项目根目录下的
vendor目录 →Mark Directory as → Excluded（排除），避免 IDE 尝试解析全部第三方代码拖慢索引 - 再右键点击
vendor/autoload.php→Mark as PHP Include Root，明确告诉 IDE 这是自动加载起点 - 更稳妥的做法：进
Settings → Languages & Frameworks → PHP → Composer，勾选Enable composer library detection，并确认composer.json路径正确（必须是项目根目录下那个）
PSR-4 路径与命名空间不一致，IDE 无法推导类位置
类文件物理路径和 namespace 声明不严格对齐时，IDE 推断失败，但 composer dump-autoload 生成的映射仍可能让运行时成功——这就造成「能跑但爆红」的错觉。
- 检查报错类的完整命名空间，比如
AppModelsUser，对应文件路径必须是app/Models/User.php（注意大小写，Linux 服务器区分，IDE 默认也严格校验） - 打开
composer.json的autoload.ps r-4段，确认映射关系如"App\": "app/"，末尾反斜杠和路径斜杠都不能少、不能多空格 - 执行
composer dump-autoload -o更新自动加载映射后，再触发一次Invalidate Caches，否则 IDE 不会重新读取新生成的vendor/composer/autoload_psr4.php
PHP 解释器或语言级别配置错位，影响类型推断
IDE 用错 PHP 版本或解释器路径，会导致命名空间解析、返回类型提示等底层能力失效，间接表现为类找不到。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Languages & Frameworks → PHP，确认CLI Interpreter指向正确的 PHP 可执行文件（例如/usr/bin/php或 WSL 中的/usr/bin/php），不是空值或旧版本 - 检查
Language level是否匹配项目实际使用的 PHP 版本（如项目用 PHP 8.2，这里不能设成 7.4），否则 IDE 会跳过解析新语法声明的类 - 如果用了远程解释器（Docker/WSL），确保
Path mappings正确：本地项目路径必须精确映射到容器内路径，否则 IDE 查找文件时会“迷路”
php -f index.php 能跑通，就别碰代码逻辑——先把 Invalidate Caches 和 Mark as PHP Include Root 做完，再看是否还红。 
