PhpStorm不设“项目根目录”路径，而是通过标记Sources Root定义代码起点；标错或漏标会导致跳转失效、补全异常、Find Usages误扫HTML文件。
Sources Root 来定义代码起点，而不是填一个路径框。标错或漏标，直接导致跳转失效、命名空间补全乱码、Find Usages 扫出一堆 HTML 文件。
为什么不能直接设“项目根目录”路径？
PhpStorm 的项目结构基于「内容根目录（Content Root）」+「目录类型标记」两层机制：Content Root 是你打开项目的那个文件夹（自动识别），但 IDE 不知道哪部分是 PHP 源码；真正起作用的是你在其中某个子目录上点的 Mark Directory as → Sources Root。只有被标为 Sources Root 的目录，才会被当作 PSR-4 命名空间的根、参与符号索引、支持 Ctrl+Click 跳转。
标 Sources Root 的正确位置和常见错误
多数项目只需标一次，但位置必须精准：
- Composer 项目：通常标
src（不是项目顶层，也不是vendor）；Laravel 默认标app；Symfony 标src；纯脚本项目可标项目根目录本身 - 绝对别标
public、web、dist、var—— 这些不是源码，标了会导致Go to Declaration在 HTML 里点App\Http\Controllers\X时失败，且索引暴涨 - 如果标了错目录（比如只标了
src/Http却漏了src/Models），类就“消失”了：写new User()时 Ctrl+悬停显示 “Not found” - 多个源码区（如
src+tests）可以都标为Sources Root，但tests建议标为Test Sources Root（右键 → Mark Directory as → Test Sources），这样 PHPUnit 配置和覆盖率统计才准
vendor 目录要不要标？怎么标？
不用手动标，也千万别标成 Sources Root：
- Composer 项目中，只要
composer.json在项目根目录，PhpStorm 启动时会自动识别vendor/autoload.php并把vendor下符合 PSR-4 的包（如vendor/laravel/framework/src/Illuminate）当作库源码处理 - 如果
vendor下某包没被识别（比如私有包未走 autoload），可单独右键该包目录 →Mark Directory as → Sources Root，但仅限该包，不要标整个vendor - 标整个
vendor会导致索引卡死、内存爆满，且破坏 PhpStorm 对第三方代码的只读保护逻辑
怎么验证 Sources Root 是否生效？
别只看目录颜色变绿，要实测行为：
立即学习“PHP免费学习笔记（深入）”；
- 在任意 PHP 文件里写一个已知类名（如
App\Models\User），按住Ctrl（macOS 是Cmd）悬停，看是否显示 “Declaration found in …” - 新建类时，IDE 是否自动补全命名空间？比如在
src/Models下建Post.php，类声明应为namespace App\Models;，而不是空或错的 - 打开
File → Project Structure → Modules → Sources，确认绿色标记出现在你预期的目录上，且路径是绝对路径（不是相对或空） - 如果
vendor/autoload.php打开后顶部没有 “Composer autoloader” 提示，说明项目根目录下缺composer.json或路径不对，需检查是否用 “Open” 而非 “New Project” 导入
Sources Root 之后，public/index.php 里的 app() 或 resolve() 仍报 “Cannot find declaration”。这不是 Sources Root 没标对，而是 public 缺少 Resources Root 标记，或没配 include_path，得单独处理。 
