Laravel Idea插件误将UUID类型ID提示为int，如何调整设置？

以下是几种能让插件正确识别UUID主键/外键类型的方案，按优先级排序：

1. 调整Laravel Idea插件的核心设置 #

打开PhpStorm设置（快捷键⌘+,），导航到Languages & Frameworks > PHP > Laravel Idea，切换到Model Helper标签页：

• 勾选Detect UUID primary keys from model traits（部分版本可能显示为「识别模型Trait中的UUID主键」），让插件通过模型引入的HasUuids trait自动判断主键类型为string|null。
• 找到「外键类型检测」相关选项，设置为「优先从迁移文件读取类型」，确保foreignIdFor定义的char(36)外键被正确识别。

2. 模型内添加属性类型声明（不破坏符号跳转） #

不要直接手动修改助手文件的PHPDoc，而是在模型类中显式声明属性类型：

class Post extends Model
{
    use HasUuids;

    // Laravel 9+支持直接声明属性类型
    public ?string $id = null;
    public ?string $user_id = null; // 对应外键字段
}

Laravel Idea生成助手文件时会优先读取模型内的类型声明，同时PhpStorm的符号跳转功能不受影响——IDE会优先识别类自身的属性定义。

3. 开启迁移文件同步 #

在Laravel Idea设置中找到Migration Sync板块，勾选Sync model attributes from migrations，强制插件完全基于迁移文件的字段类型来生成助手文件。这能彻底解决外键类型被误判为int的问题。

4. 清除旧助手文件重新生成 #

删除vendor/_laravel_idea/下所有ide_helper_models*.php文件，再执行代码生成快捷键⌘⇧,，确保新设置生效后生成正确的类型提示文件。

内容的提问来源于stack exchange，提问作者Phil Tune