PhpStorm需手动标记源码根目录并配置命名空间才能正确解析Composer自动加载规则。确认composer.json在项目根目录且格式规范，启用自动加载后需手动标记如app/为Sources Root并在Properties中填写对应Namespace（如App），最后执行Reload project生效。
PhpStorm 默认无法自动感知 Composer 自动加载规则，尤其是 psr-4 或 classmap 中定义的非标准路径时，会导致代码跳转失效、类型提示缺失、未解析符号警告等问题。解决的关键不是“刷新索引”或“重启”，而是让 IDE 明确知道哪些目录应被当作源码根（Sources Root）并绑定到对应命名空间。
确认 composer.json 中的 autoload 配置是否被 PhpStorm 读取
PhpStorm 从 2019.3 起支持自动解析 composer.json 的 autoload 和 autoload-dev 字段，但仅限于项目根目录下的文件，且要求格式规范：
-
"psr-4"必须是键值对，键为命名空间前缀（含末尾反斜杠，如"App\\"），值为相对于composer.json的目录路径（如"app/"） - 不支持嵌套数组、变量插值、或使用
../向上跨目录（例如"../src"会被忽略） - 如果用了
classmap，目录路径必须存在且可读，否则 PhpStorm 不会将其加入索引范围
检查方法：打开 File → Settings → Languages & Frameworks → PHP → Composer，勾选 Enable auto-loading for Composer，再点击 Reload project 按钮 —— 此时不会弹窗提示，但底部状态栏会显示 “Resolving autoload paths…”。
手动标记 Sources Root 是最可靠的方式
当自动解析失败（比如用的是 files 加载、自定义 autoloader、或路径含符号链接），必须手动设置源码根目录。否则 Ctrl+Click 会跳到 vendor 中的类，而不是你本地重写的实现。
立即学习“PHP免费学习笔记（深入）”；
- 右键点击项目中实际存放类文件的目录（如
app/、src/、modules/user/src）→Mark Directory as → Sources Root - 若该目录对应命名空间为
UserModule\\，还需右键 →Properties→ 在Namespace栏填入UserModule（不含反斜杠） - 多个模块需分别标记；vendor 下的包无需手动标记，PhpStorm 会通过
vendor/autoload.php自动识别其结构
注意：Mark as Sources Root 会覆盖自动解析结果，所以建议先关掉自动加载选项再手动配置，避免冲突。
验证是否生效：看 IDE 是否能正确解析 new 和 use
写一段测试代码，观察是否出现红色波浪线或无法跳转：
use App\Http\Controllers\UserController; $ctrl = new UserController();
如果 App\Http\Controllers 报错“Cannot resolve symbol”，说明：
-
app/没有被标记为 Sources Root，或标记后未填对 Namespace（应为App） -
composer.json中"App\\": "app/"写成了"App\\": "app"（缺末尾斜杠）或"App\\": "./app/"（带点号） - 目录名大小写与命名空间不一致（Linux 下敏感，Windows 可能掩盖问题）
另外，运行 composer dump-autoload -o 后，记得在 PhpStorm 中执行 File → Reload project from Disk，否则 IDE 可能仍缓存旧的 classmap。
最常被忽略的一点：IDE 不会动态监听 composer.json 变更。哪怕你改了 autoload 配置，也不触发自动重载 —— 必须手动点一次 Reload project 或重启项目。别指望保存文件就生效。
