PhpStorm靠手动标记Sources Root定义源码起点，而非自动识别；标错或漏标会导致跳转、补全、命名空间解析全部失效。正确做法是右键src/app等实际PHP目录→Mark Directory as→Sources Root，避免标public/vendor等非源码目录，并确保vendor/autoload.php被识别为Composer autoloader。
PhpStorm 不是“识别 PHP 目录”，而是靠你手动标记 Sources Root 来告诉它哪里是源码起点；标错或漏标，Go to Declaration、自动补全、命名空间解析全会失效。
为什么 PhpStorm 找不到你的 PHP 类或函数
常见现象：Cannot find declaration to go to、Ctrl+Click 类名无反应、use 语句下划红线、new SomeClass() 提示未定义——这些问题 90% 源于 Sources Root 没标对或根本没标。
- PhpStorm 不会自动扫描整个项目找 PHP 文件；它只索引被标记为
Sources或Test Sources的目录 - 如果只标了
src/Http却漏了src/Models，那 Models 下的类就“不存在”于 IDE 视图中 - 标在
public或var这类非源码目录上，会导致索引污染：HTML 里写个app()也被当 PHP 函数去查，结果报错又拖慢性能
怎么正确标记 Sources Root
操作本身很简单，但关键在选对目录：
- 右键你实际放 PHP 类文件的最外层目录（通常是
src、app、或项目根目录本身）→Mark Directory as→Sources Root - 多个独立源码区可分别标：比如
src和tests都标成Sources Root和Test Sources - 别碰
vendor：Composer 自动识别为库目录，标成Sources Root会触发全量重索引，卡死 IDE - 标错后右键该目录 →
Unmark as Sources Root即可撤回，无副作用
vendor/autoload.php 不生效？先看这个
即使 Sources Root 标对了，vendor/autoload.php 若没被识别，PSR-4 自动加载路径仍无法参与补全和跳转。
立即学习“PHP免费学习笔记（深入）”；
- 打开
vendor/autoload.php，顶部应显示 “Composer autoloader” 提示；没有说明 PhpStorm 没把它当入口文件 - 检查
composer.json是否在项目根目录；不在的话，IDE 不会触发自动加载逻辑 - 若用了 Laravel，
public/index.php中的app()等全局函数可能需额外加@var注释或配置include_path
多模块项目容易忽略的点
像 core/、admin/、api/ 各自带 src 的结构，不能只标一个 Sources Root。
- 每个模块的
src都要单独右键 →Mark Directory as→Sources Root - 确保各模块的
composer.json里autoload路径指向的是自己模块内的src，否则命名空间映射会错乱 - 别指望 IDE 自动合并多个
src目录下的命名空间；它按目录物理位置分片索引，跨目录引用必须显式use
最常被跳过的动作：标完 Sources Root 后没 reload project 或清缓存。哪怕标记看起来生效了，旧索引残留也可能让跳转继续失败——遇到怪问题，先试 File → Reload project from Disk，再不行就 Invalidate Caches and Restart。
