直接用原生ReflectionClass即可，因其实例化时才解析、由Zend引擎提供且缓存友好；第三方封装如doctrine/reflection仅提供语法糖（如注解过滤、空值返回），反而增加对象创建与调用开销，无性能提升。
为什么直接用 ReflectionClass 就够了，别封装
PHP 的反射机制本身没有运行时损耗——ReflectionClass、ReflectionMethod 等类在实例化时才解析类结构，且底层由 Zend 引擎直接提供，缓存友好。所谓“零损耗封装”是个伪命题：任何 Composer 库（比如 php-di/invoker 或 doctrine/reflection）加一层抽象，必然引入额外对象创建、方法调用和参数转发，反而增加开销。
doctrine/reflection 这类库实际做了什么
它只是对原生反射 API 做了轻量包装，比如把 getDocComment() 解析成数组、统一处理 PHP 8.0+ 的属性类型，或补全老版本缺失的 hasReturnType()。它不加速反射，也不绕过 Zend 的解析逻辑。
- 真正省事的是语法糖，不是性能优化
- 它会自动忽略
@internal注解标记的方法（原生不会） - 部分方法返回
null而非抛出ReflectionException，需注意空值判断 - 依赖 PHP 7.4+，在 PHP 8.2 下某些
getAttributes()行为与原生不一致
想“零损耗”，就别碰任何第三方反射封装
如果你需要高频反射（比如 DI 容器初始化阶段），正确做法是：缓存 ReflectionClass 实例，复用而非重复 new；用 class_exists() 和 method_exists() 做快速前置判断，避免无谓反射；对固定类结构，直接硬编码替代运行时反射。
- 缓存示例：
$refCache[$className] ??= new ReflectionClass($className) - 不要用
new \Doctrine\Reflection\ReflectionClass($class)替代原生 —— 多一次构造函数调用 + 属性赋值 - PHP 8.1+ 可用
ReflectionClass::getConstructor()?->getParameters()直接链式调用，无需封装
Composer install 的 phpdocumentor/reflection-docblock 是另一回事
它只负责解析 DocBlock 字符串（比如 @param string $name），不参与类/方法结构反射。如果你混淆了“文档注解解析”和“运行时反射”，就会误以为装个包就能优化反射性能。
立即学习“PHP免费学习笔记（深入）”；
- 它依赖
phpdocumentor/type-resolver，会触发大量字符串正则和 AST 构建 - 每次调用
Tag::createInstance()都是新对象，无法复用 - 仅在生成 API 文档或 IDE 插件中必要，业务逻辑里不该出现
反射本身没问题，问题总出在滥用时机和忽视缓存。写完 new ReflectionClass 后多看一眼是否真需要它，比挑哪个库“更轻量”实在得多。
