PHP静态属性类型必须用@var注释在声明上方，不支持原生类型声明；静态方法返回自身时应使用@return static而非@return self；PHP 8.2+仍不支持静态属性类型声明，IDE补全是错误的；静态成员需在测试中手动重置。
PHP 中静态成员的注释，必须用 PHPDoc 标准写法，且需明确标注 @var 或 @property-static，否则 IDE 和静态分析工具（如 PHPStan、Psalm）无法正确识别类型。
静态属性必须用 @var 注释在声明上方
PHP 不支持在 static 关键字后直接写类型（PHP 8.2+ 才支持属性类型，但静态属性仍不支持原生类型声明），所以类型信息完全依赖 PHPDoc。
- 注释必须紧贴在
public static等声明之前，中间不能有空行 - 类型写在
@var后，支持泛型语法（如array<string, int>） - 不要写成
@property—— 那是用于魔术属性（__get/__set）的
/**
* 用户状态映射表
* @var array<string, int>
*/
public static $statusMap = [
'active' => 1,
'inactive' => 0,
];静态方法的注释和普通方法一致，但要标 @return static 当返回自身时
如果静态方法返回当前类实例（常见于静态工厂或 fluent 接口），@return static 比 @return self 更准确，能保留子类上下文。
-
@return self在继承链中会固定指向定义该方法的类 -
@return static支持 late static binding，实际返回调用者的类名 - 参数用
@param，和普通方法无区别
/**
* 创建一个预配置的实例
* @param string $type
* @return static
*/
public static function make(string $type): static
{
$instance = new static();
$instance->type = $type;
return $instance;
}PHP 8.2+ 静态属性仍不能声明类型，别被 IDE 自动补全误导
即使你在 PHPStorm 里看到 public static string $name; 这样的提示，它只是 IDE 的推测或错误补全 —— PHP 解析器会直接报错 ParseError: Syntax error。
立即学习“PHP免费学习笔记（深入）”；
- PHP 8.2 引入的是“只读类属性”和“允许在属性上使用
static类型”，但不是“静态属性类型声明” - 真正支持的写法只有：
public readonly string $name;（非 static） - 所有
static属性的类型，只能靠@var维护
最易被忽略的一点：很多团队把静态成员当全局变量用，结果在单元测试中互相污染。哪怕注释再规范，也得配合 setUp() / tearDown() 重置静态状态 —— 注释管不了运行时行为。
