PHPStorm 识别 Eloquent 属性类型依赖 @property 注解，$casts 等运行时配置不参与静态分析；需配合 Laravel Idea 插件生成注解，并用 Larastan/ Psalm 插件增强类型检查。
PHP 本身不支持 Eloquent 属性类型推断，Laravel 也不提供运行时自动推导字段类型的机制；所谓“Attribute Inference”是 IDE（如 PHPStorm）或静态分析工具（如 PHPStan、Psalm）基于约定和注解做的类型提示补全，不是 Laravel 的运行时能力。
PHPStorm 怎么识别 Eloquent 模型属性类型
PHPStorm 依赖 @property PHPDoc 注解或模型中显式定义的 $casts、$dates、$appends 等属性来推测字段类型。它不会解析数据库 schema 或执行 SQL 来反推。
- 没加
@property注解时，IDE 默认把所有属性当mixed处理 - 加了
@property string $name后，自动补全和类型检查才生效 - 如果字段在
$casts里声明为'active' => 'boolean'，PHPStorm 仍需对应@property bool $active才能正确识别 - 使用 Laravel Idea 插件可自动生成基础
@property注解，但需手动更新（比如加了新字段后要重新生成）
为什么 $casts 不足以让 IDE 推断类型
$casts 只影响 Eloquent 的序列化/反序列化行为，不参与静态类型分析。PHPStorm 和 PHPStan 都不读取运行时数组配置。
-
$casts = ['price' => 'decimal:2']→ 实际存的是字符串，但 IDE 不知道这个映射关系 -
$casts = ['published_at' => 'datetime']→ 返回Carbon实例，但 IDE 无法从字符串字面量推断出对象类型 - 必须配对写：
@property Carbon|null $published_at，否则跳转定义、参数提示都失效 - 第三方 cast 类（如
AsArrayObject）更需要显式注解，否则 IDE 完全无法识别返回结构
怎么让 PHPStan / Psalm 支持 Eloquent 属性类型检查
需配合插件 + 手动配置，否则默认会报 Access to an undefined property 错误。
- 安装
larastan/larastan（PHPStan）或psalm/plugin-laravel（Psalm） - 在
phpstan.neon中启用扩展，并指定模型路径：paths: [app/Models] - 确保每个模型都有完整
@property注解，包括$fillable、$appends、HasOne/HasMany关系字段 - 关系方法如
user()返回BelongsTo，但访问$model->user->name要靠插件解析方法返回值 + 关联模型注解才能链式推断
真正起作用的从来不是“自动推断”，而是你有没有坚持写准确的 @property 注解、有没有用对 cast 类型、有没有配好静态分析插件。漏掉任意一环，IDE 补全就断、类型检查就飘、协作时别人打开你的模型第一反应就是“这属性到底是什么类型”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
