phpdoc中@param/@return类名无法跳转，是因为未使用完整命名空间（如\app\models\user），且类未被索引；仅原生类型（void、int等）和已索引的完整类名才支持跳转。
PHPDoc 里 @param/@return 中的类名为什么点不跳转
默认情况下，@param User $user 或 @return Collection 这类注释里的类名不会高亮，更不会 Ctrl + B 跳转——不是 PhpStorm 坏了，而是它没把这串文本识别为“可解析类型”。关键在于类型字符串是否符合 PHPStorm 的解析规则。
- 必须用完整命名空间（如
@param \App\Models\User $user），相对命名空间（User）或别名（@param UserContract $user）默认不触发跳转 - 类名中间不能有空格、括号、泛型符号（
array<string int></string>、User|null中的|和会中断解析） - 如果类在当前文件没 use，又没写全名，PhpStorm 无法定位——它不靠运行时 autoload 推断，只靠静态索引
- Laravel 的
@mixin、Doctrine 的@Entity等自定义标签不参与类型跳转，仅@param、@return、@var和类级@property支持
怎么让 @param \App\Models\User $user 可跳转
光写对还不行，得让 PhpStorm “信”这是个真实类。最稳的方式是：在注释中显式使用带反斜杠的绝对命名空间，并确保该类已被索引。
- 确认类文件在项目中且被标记为 Sources Root（右键目录 → Mark as → Sources Root）
- 避免缩写：不要写
@param App\Models\User（缺开头\），必须是@param \App\Models\User - 对于接口或抽象类，同样适用；但 trait 不支持跳转，即使写了全名
- 如果类名拼写正确却仍无法跳转，执行
File → Reload project from disk或File → Invalidate Caches and Restart → Just Restart
@var 和 @property 怎么写才能让属性类型可跳转
类属性动态赋值（如 $this->user = new User();）时，IDE 报 “Undefined field” 是常见问题。解决依赖的是 @property 标签，但它必须满足格式和位置双重约束。
-
@property必须写在类的 PHPDoc 块内，紧贴class关键字正上方（不是方法里，也不是属性上方） - 格式严格：
@property \App\Models\User $user—— 类型、空格、变量名三者缺一不可；@property User $user不生效 -
@var只对局部变量有效（如函数内/** @var \App\Models\User $user */），写在属性声明上方无效（/** @var User $user */ public $user;不被识别） - 数组类型要拆开写：
@property \App\Models\User[] $users可跳转；@property array $users不解析
为什么有些 @return void 写了也跳不了，而 @return \Illuminate\Http\Response 就可以
根本区别不在“有没有反斜杠”，而在 PhpStorm 是否将该字符串映射到一个已知的、可索引的类。void 是语言内置关键字，不是类；Response 是真实存在的类，且只要路径正确就能命中。
-
@return void、@return bool、@return int这些原生类型永远不跳转——它们本就不该跳 -
@return \Illuminate\Http\Response能跳，前提是vendor/laravel/framework/src/Illuminate/Http/Response.php已被索引（通常 Composer 自动完成） - 自定义返回类型如
@return \MyApp\Dto\Result，若文件存在但未被识别，检查是否在Settings → PHP → Include paths中漏加了 Dto 目录 - 别指望
@return static或@return self跳转——它们是上下文相关类型，PhpStorm 不解析
实际跳转能力取决于命名空间书写精度、文件索引状态和类型本身是否可定位。写对只是第一步，后续得让 IDE “看见”那个类。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
