核心是将vendor标为Sources Root并添加PHPDoc类型注释：右键vendor→Mark as Sources Root，控制器中声明/* @var \think\Request $request /，模型顶部加@property注释，路由用伪routes.php数组映射。
PhpStorm 要让 ThinkPHP 项目“看得见、点得进、补得全”，核心就两件事：告诉它 vendor 是代码来源，再帮它搞清楚运行时对象的类型。其他所有问题——路由跳不进去、模型字段标红、app('request') 提示 undefined——基本都卡在这两个环节上。
为什么 vendor 目录必须手动标为 Sources Root
ThinkPHP 的类（比如 think\Route、think\Model）全在 vendor/topthink/thinkphp 下，但 PhpStorm 默认只扫描你标记为源码根目录的文件夹。不标，它就当 vendor 是普通依赖包，不解析里面任何类定义。
- 右键点击项目根目录下的
vendor文件夹 → Mark Directory as → Sources Root - 别只标
vendor/topthink/thinkphp子目录——think-orm、think-helper这些独立包也得一并覆盖 - 多应用模式（如
app/app1/）下，还要把对应应用的controller和model目录也标为 Sources Root - 标完立刻按
Ctrl + Shift + O（Win/Linux）或Cmd + Shift + O（macOS）强制重新索引
怎么让 $this->request 或 app('request') 有完整提示
ThinkPHP 大量使用容器绑定和魔术属性，$this->request 在 PHP 层面是动态挂载的，IDE 静态分析时根本不知道它是什么类型。不加声明，就只能看到 “undefined property” 报错。
- 在控制器类开头加 PHPDoc 声明：
/** @var \think\Request $request */ - 对
app()获取的对象，用断言写法：$request = app('request'); /** @var \think\Request $request */ - 避免直接访问未声明的
$this->app——TP 5.1+ 已弃用，改用$this->app->make('request')或构造器注入 - 不要把 Settings → Editor → Inspections → PHP → Undefined class 设成 Error 级别，否则满屏红色干扰编码
模型字段提示为什么总报错，怎么低成本解决
ThinkPHP 模型字段来自数据库表结构，是运行时反射读取的，IDE 无法静态推导。写 $user->name 标红不是 bug，是设计使然。
立即学习“PHP免费学习笔记（深入）”；
- 最轻量方案：在模型类顶部手写
@property注释，例如：/** @property int $id @property string $name @property string $email */ - 字段频繁变动？可用
think-ide-helper生成注释，但它只输出到_ide_helper.php，必须手动复制粘贴进模型文件，不能全自动同步 - 千万别靠
__get()或重写魔术方法绕过提示——这会让 PhpStorm 彻底放弃类型推断 - 生成的
_ide_helper.php如果和手写注释冲突，反而会让提示更乱，删掉它比留着更安全
路由跳转失效，Route::get() 点不进目标控制器
ThinkPHP 的路由注册是运行时调用（比如 route/route.php 里写 Route::get('/user', 'User/index')），不是静态语法结构，PhpStorm 无法从字符串反向解析到控制器方法。
- 别指望
Route::get()第二个参数里的字符串能自动跳转——它只是个字符串，不是引用 - 稳妥做法：在
app/下新建一个routes.php（仅用于 IDE），用数组模拟映射：return ['/user' => 'app\controller\User@index']; - 如果用了 Laravel Idea 插件，可配合
@route注解，但原生 ThinkPHP 不支持该注解，纯属插件额外能力 - 多应用模式下，伪路由文件路径要和实际应用命名空间严格匹配，否则提示仍无效
真正容易被忽略的是：所有这些配置都依赖 PhpStorm 正确识别了 PHP 解释器和 Composer 路径。如果 which php 和 which composer 返回的路径没在 Settings 里填对，标记再准、注释再全，索引也建不起来。
