PhpStorm通过标记Sources Root而非设置路径来识别代码起点，未标记会导致跳转、补全等功能失效；应右键src等源码目录→Mark Directory as→Sources Root，避免标记public等非源码目录。
PhpStorm 里怎么标记 Sources Root
项目根目录不是靠“设置路径”指定的，而是靠标记 sources root 来告诉 phpstorm 哪里是代码起点。不标这个，跳转、补全、引用分析全会失效。
操作很简单：右键项目里实际放 PHP 文件的文件夹 → Mark Directory as → Sources Root。通常就是 src、app 或直接是项目顶层文件夹。
- 如果项目用 Composer，
vendor自动被识别为库目录，别手贱标成 Sources Root - 多个源码目录（比如
src和tests）可以分别标，但别把public或var标进去——它们不是源码 - 标错后右键目录 → Unmark as Sources Root 就能撤回，没副作用
为什么 public 目录不能标成 Sources Root
标了 public 会导致 PhpStorm 把里面所有文件（比如 index.php、静态资源）当成可跳转/可索引的源码，结果：Go to Declaration 在 HTML 里点 PHP 函数名会失败，Find Usages 会扫出一堆无意义的 HTML/JS 引用，索引变慢，内存占用飙升。
正确做法是保持 public 不标记，只把它设为 Resources Root（右键 → Mark Directory as → Resources Root），这样 PhpStorm 才知道这里放的是 Web 入口和静态资源，不参与代码分析。
-
Resources Root只影响路径解析（比如require或 Twig 模板路径提示），不影响符号索引 - 如果用了 Laravel，
public下的index.php通常要加@var注释或配置include_path才能正确解析app()等全局函数
配置错误导致 “Cannot find declaration to go to” 怎么查
这个提示八成是因为 Sources Root 没标对，或者标在了子目录里（比如只标了 src/Http 却漏了 src/Models），导致 PhpStorm 根本不知道你的类定义在哪。
立即学习“PHP免费学习笔记（深入）”；
快速排查步骤：
- 打开
File → Project Structure → Modules，看Sources标签页下有没有绿色的根目录标记 - 在任意 PHP 文件里写一个已知存在的类名，按住
Ctrl（macOS 是Cmd）悬停，看是否显示 “Declaration found in …” - 如果显示 “Not found”，右键该类所在目录 → Mark Directory as → Sources Root
- 确认
vendor/autoload.php被正确识别：打开它，看顶部是否有 “Composer autoloader” 提示，没有就检查composer.json是否在项目根目录
多模块项目怎么设多个 Sources Root
比如你有 core、admin、api 三个独立模块，每个都有自己的 src，就得分别标记。PhpStorm 支持一个项目里多个 Sources Root，但必须手动逐个标，不会自动递归识别。
注意点：
- 每个
Sources Root必须是物理上独立的文件夹，不能嵌套（比如标了modules后再标modules/admin/src，后者会被忽略） - 如果模块间有依赖，确保它们的命名空间和
composer.json的autoload配置一致，否则跳转会断 - 改完记得点
File → Synchronize，不然缓存可能还按旧结构索引
Sources Root 和 Resources Root 时，很容易让路径解析和代码分析打架。 
