PhpStorm中vendor目录需设为Sources Root并配置PSR-4映射，路由字符串和模型字段需手动添加@route注解或@property注释，Facade链式调用应通过容器注入或@method注释增强提示。
vendor目录没被标记为Sources Root，类名点不进去
PhpStorm默认不把vendor当代码源，thinkRoute、thinkModel这类类名点不开，方法也没提示。这不是ThinkPHP的问题，是IDE根本没加载定义位置。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 右键项目根目录下的
vendor文件夹 → Mark Directory as → Sources Root - 确认
composer.json里有正确的PSR-4映射，例如："autoload": {"psr-4": {"think\": "vendor/topthink/thinkphp/library/think/"}}（TP6路径可能为vendor/topthink/thinkphp/src/，按实际调整） - 标完后按
Ctrl + Shift + O（Win/Linux）或Cmd + Shift + O（macOS）强制重新索引，等右下角进度条消失再试
Route::get()参数是字符串，跳转不到控制器方法
ThinkPHP路由是运行时注册的，Route::get('user/:id', 'user/info')里的'user/info'只是个字符串，PhpStorm无法静态解析目标方法——它不是引用，也不是类方法调用。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在控制器方法上方加
@route注解（需配合插件如 Laravel Idea 才生效），但原生TP不支持，不推荐强依赖 - 更稳妥的做法：在
app/下手动建一个routes.php伪文件，用数组模拟映射，仅用于IDE识别，例如：return [ 'user/:id' => [AppControllerUser::class, 'info'], ]; - 多应用模式（如
app/admin/）下，记得把对应controller目录也标为Sources Root，否则控制器类找不到
模型字段没提示，$user->name报“Field not found”
TP模型字段从数据库动态读取，IDE无法推断。运行完全正常，但编辑器会标黄、无补全、无跳转。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在模型类顶部写
@property注释，例如：/** * @property int $id * @property string $name * @property string $email * @property DateTimeInterface $created_at */
- 避免用
__get()或__call()绕过提示——这会让IDE彻底放弃类型推断 - 表结构频繁变动时，可用
topthink/think-ide-helper生成注释，但生成结果必须手动合并进模型文件，不能全自动覆盖；开启后反而提示错乱，说明它和手写注释冲突，优先删掉生成的_ide_helper.php并回归手写
用了Facade门面，但方法名不提示
像Db::table('user')->where(...)这种写法，Db是门面类，底层靠容器+反射调用，PhpStorm抓不到真实方法签名。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要指望IDE自动补全Facade链式调用，这是框架设计决定的，非配置问题
- 可临时切换为容器注入方式，例如在构造函数中声明
protected Query $query;，这样$this->query->where(...)能获得完整提示 - 或直接在Facade类（如
vendor/topthink/think-orm/src/Facade/Db.php）上补@method注释，参考知识库中对Model.php的处理方式，给Db门面加上常用Query方法声明
路由跳转和模型字段提示这两个点，最容易被当成“配置没搞好”反复折腾，其实它们本质是框架运行时机制与IDE静态分析之间的天然断层。手写注释和伪路由文件不是权宜之计，而是目前最稳定、副作用最小的解法。
