PHPStan 1.10+ 已原生支持泛型，无需额外扩展包；需确保版本≥1.10.0、PHP≥8.1、使用原生泛型语法、避免禁用扩展或误装旧包。
PHPStan 1.10+ 已原生支持泛型，不需要额外 Composer 扩展包
PHPStan 自 v1.10.0（2023 年 10 月发布）起，已将泛型（class Foo<t></t>、function bar(): T 等）作为核心能力内置，不再依赖第三方扩展。你如果还在找 phpstan/phpstan-generics 或类似包，大概率是查到了过时文档。
常见错误现象：PHPStan\Analyser\LazyUnionType 报错、泛型类型被忽略、T 被当成未定义类名报 Class T not found —— 这些通常不是缺扩展，而是 PHPStan 版本太低或配置没开泛型解析。
- 确认当前版本：
composer show phpstan/phpstan，必须 ≥1.10.0 - 旧项目升级后仍不生效？检查是否在
phpstan.neon中禁用了类型推导相关扩展（如误加了disableExtensions: [phpstan]） - 泛型支持默认开启，无需额外配置项；但若用
level: 9以上，才可能触发深度泛型校验（比如方法返回值与泛型约束一致性）
如何让 PHPStan 正确识别你的泛型类和方法
光有高版本不够，PHPStan 需要能“看懂”你写的泛型语法。它只识别 PHP 8.1+ 原生泛型（class Collection<t></t>），不支持 PHPDoc 伪泛型（如 @template T）的完整推导 —— 后者仅用于兼容老代码，且能力有限。
- 确保 PHP 版本 ≥
8.1，且项目中使用的是原生语法，不是靠@template模拟 - 泛型类必须显式声明约束（如
class Repository<t of entity></t>），否则T默认为mixed，校验会变弱 - 方法中使用泛型参数时，需配合
static或明确返回类型，例如：public function get(): T；若写成public function get(): self，泛型信息就丢失了 - 避免在 trait 中直接定义泛型类（PHP 限制），可把泛型逻辑下沉到具体类中实现
Composer 安装时容易踩的坑：别装错包，也别锁死旧版本
搜索 “PHPStan 泛型” 时，很多人会顺手装上 phpstan/phpstan-strict-rules 或第三方 phpstan-extension，结果反而干扰泛型解析 —— 这些包没适配新泛型模型，甚至会覆盖核心类型处理器。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
立即学习“PHP免费学习笔记（深入）”；
- 只要运行
composer require --dev phpstan/phpstan:^1.10即可，**不要**再装phpstan/phpstan-generics（该包已归档，README 明确标注 “deprecated”） - 检查
composer.json是否锁死了"phpstan/phpstan": "^0.12"类旧版本 —— 这种写法会阻止升级到 1.x，必须手动改为"^1.10"并运行composer update phpstan/phpstan - 如果你用的是 Laravel / Symfony 等框架集成包（如
phpstan/extension-installer），确认其版本兼容 PHPStan 1.10+（extension-installer v2.0+才支持）
泛型静态分析真正难的地方不在安装，而在类型建模本身
PHPStan 能读泛型，不代表它能自动猜出你想要的约束逻辑。比如 Collection<int></int> 和 Collection<string></string> 在运行时是同一个类，但静态分析需要你主动告诉它“这个变量此刻绑定的是哪种 T”。
- 构造函数传参、工厂方法返回值、方法链调用中泛型传递，都依赖你写清楚类型注解（哪怕只是
@return static<t></t>） - 复杂嵌套泛型（如
Promise<array result>>></array>）容易超出 PHPStan 当前推导能力，报Type inference failed—— 这时得拆解中间变量并加@var注解 - IDE（如 PHPStorm）对 PHP 8.1+ 泛型的支持仍滞后于 PHPStan，别指望补全或跳转完全准确；以 PHPStan 的报错为准，而不是编辑器提示
泛型不是开关一开就万事大吉的东西，它把类型建模的责任更多交还给了人。装对版本只是起点，后面每一步类型声明，都得你自己想清楚。
