如何仅通过PHP属性实现IDE对类型化数组的自动提示与补全？

要让IDE仅通过#[ArrayOf(Hobby::class)]属性识别数组元素类型，核心是给你的ArrayOf属性类添加类型提示用的PHPDoc注释，让IDE能解析这个属性携带的类型信息。以下是具体步骤：

1. 给ArrayOf属性类添加模板化PHPDoc #

在定义ArrayOf属性的类中，通过@template和@param标记关联泛型类型，同时指定属性的作用目标：

<?php

/**
 * @template T
 * @target property
 */
#[\Attribute(\Attribute::TARGET_PROPERTY)]
class ArrayOf
{
    /**
     * @param class-string<T> $className
     */
    public function __construct(public string $className)
    {
    }
}

这里的@template T声明了泛型类型参数，@param class-string<T> $className表示传入的类名对应类型T，@target property告诉IDE这个属性专门用于标记类属性。完成后，IDE就能通过#[ArrayOf(Hobby::class)]自动推断$hobbies是Hobby[]类型，提供对应的自动补全和类型提示。

2. 确保IDE支持自定义属性的类型推断 #

• PhpStorm：更新到2021.3及以上版本，开启设置 > 语言与框架 > PHP > 高级 > 启用基于属性的类型提示（不同版本路径可能稍有差异）。
• VSCode + PHP Intelephense：将扩展更新到最新版，它对自定义模板属性的类型推断支持已经比较完善。

3. 验证效果 #

修改完ArrayOf类的PHPDoc后，回到User类去掉/** @var Hobby[] */注释，IDE应该能自动识别$hobbies的元素类型为Hobby，正常提供对象方法的自动补全和类型检查。

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