PhpStorm依赖Sources Root标记识别可索引的PHP源码目录，未标记或标错（如标在public）会导致跳转、补全失效；须右键src/app等真实类目录→Mark Directory as→Sources Root，并重索引。
为什么标错 Sources Root 就没法跳转定义
PhpStorm 不靠“项目根目录”识别代码，而是靠 Sources Root 标记告诉它：“这些文件夹里的 PHP 类是我该索引、跳转、补全的”。没标，或标在了 public、runtime 这类非源码目录下，Ctrl + Click 任何类名都会弹出 “Cannot find declaration to go to”。常见误操作是只标了 app/Http 却漏了 app/Models，导致 User::find() 能点进框架，但 $user->name 没提示。
- 右键你放控制器、模型、服务等真实 PHP 类的目录（通常是
app、src或项目顶层）→ Mark Directory as → Sources Root - 如果用了 Composer，
vendor目录不用手动标——PhpStorm 会自动识别为库目录；标了反而干扰索引 - 确认
composer.json在项目根目录，且autoload配置正确，比如 Laravel 的"psr-4": {"App\": "app/"}，否则即使标了app，类路径也对不上 - 标完立刻按
Ctrl + Shift + O（macOS 是Cmd + Shift + O）强制重新索引，别等它后台慢慢扫
Laravel / ThinkPHP / Symfony 各自要额外配什么路径
框架跳转失效，光标点不进 Route::get()、@Route 注解或 services.yaml 里的服务名，问题不在 Sources Root，而在框架专属路径没对齐。
-
Laravel：进
Settings → Languages & Frameworks → PHP → Laravel，勾选 Enable Laravel support；确保Artisan path指向项目根目录下的artisan文件，不是全局命令 -
ThinkPHP：除了标
app为 Sources Root，还要手动把thinkphp/library/think所在目录（常在vendor/topthink/thinkphp下）也标为 Sources Root，否则thinkRoute点不进去 -
Symfony：必须装
Symfony Support插件并启用；进Settings → Languages & Frameworks → PHP → Symfony，在 Configuration files 里手动加路径，比如config/packages/*.yaml和config/routes.yaml，否则 YAML 补全和路由跳转全挂
Blade / Twig / 模板里 @include 或 route() 为啥点不开
这不是路径没标对，而是 PhpStorm 默认把模板当纯文本。它不知道 @include('partials.header') 对应的是 resources/views/partials/header.blade.php，也不知道 route('user.show') 应该跳到 routes/web.php 里的声明。
- Laravel 项目：进
Settings → Languages & Frameworks → PHP → Laravel，确保 Enable Laravel support 和 Enable Blade support 都已勾选 - Symfony 项目：必须启用
Twig Support插件，并在Settings → Languages & Frameworks → PHP → Symfony中确认 Twig templates path 指向templates/或resources/views/（依项目结构而定） - 所有框架都依赖正确的
Resources Root：右键resources或templates目录 → Mark Directory as → Resources Root，这样asset()、@extends才能解析相对路径
配置完还是跳不到，优先查这三处
路径标了、插件开了、索引也重刷了，但 Auth::user() 还是灰色、AppModelsUser 依然点不进——大概率卡在这些隐性环节。
立即学习“PHP免费学习笔记（深入）”；
- 打开任意 PHP 文件，
Ctrl + Hover一个已知类（如DateTime），看是否显示 “Declaration found in …”；如果连这个都找不到，说明 PHP 解释器根本没加载成功，回 Settings → PHP → Interpreter 检查路径和版本 - 检查
vendor/autoload.php是否被正确识别：打开它，顶部应有 “Composer autoloader” 提示；没有就说明composer.json不在根目录，或 PhpStorm 没读到 - 多应用/多模块项目（如 ThinkPHP 的
app/admin、Laravel 的app/Console）容易漏标子目录，每个独立模块的入口目录都要单独标一次Sources Root
composer.json，也不随 Sources Root 自动生效，必须人工点进去加。 
