IntelliJ中Camelcade插件Perl子例程MIME::Entity参数自动补全问题

在使用Camelcade插件时，子例程接收MIME::Entity类型参数时IDE无法识别类型导致自动补全失效，可通过以下几种方式让IDE识别参数类型：

方法1：添加变量类型注释 #

在参数声明行尾添加# type: MIME::Entity注释，直接告知IDE变量的具体类型：

sub subWithAutocompleteOnEntity
{
        my ($entity) = @_; # type: MIME::Entity
        if ($entity->parts(0)) {
           print("Say hello")
        }
}

方法2：使用POD类型注解 #

在子例程上方添加POD格式的类型说明，这种方式更规范，也能被IDE正确识别：

=for comment type: sub(MIME::Entity)
sub subWithAutocompleteOnEntity
{
        my ($entity) = @_;
        if ($entity->parts(0)) {
           print("Say hello")
        }
}

方法3：优化bless写法（辅助类型识别） #

你代码里的bless $entity, $test写法可简化为直接指定包名，让IDE更容易关联到MIME::Entity类型：

sub subWithAutocompleteOnEntity
{
        my ($entity) = @_;
        bless $entity, 'MIME::Entity'; # 直接指定目标包名
        if ($entity->parts(0)) {
           print("Say hello")
        }
}

另外补充：调用子例程时传入的$entity已经是MIME::Parser解析出的MIME::Entity对象，其实无需再次bless，直接使用即可——这也能让IDE在调用阶段更准确地推断参数类型。

内容的提问来源于stack exchange，提问作者Alexander Petrov