可行且推荐用#[Table]和#[Column]替代@注释，但需显式指定Attribute目标（如TARGET_CLASS|TARGET_PROPERTY）、PHP 8.1+支持重复、必须通过ReflectionAPI读取、Attribute类须自动加载。
直接用 #[Table] 和 #[Column] 替代 @Table / @Column 注释，是可行且推荐的——但必须配合反射 + 显式目标约束，否则运行时读不到、IDE 提示失效、类型校验形同虚设。
定义 Table 和 Column Attribute 时必须指定 Target
不加 flags 的 #[Attribute] 默认只允许用在类上（Attribute::TARGET_CLASS），而字段映射需要同时支持类和属性。常见错误是定义了 #[Column] 却只能标在类上，标在属性时报错或静默忽略。
-
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_PROPERTY)]才能让#[Column]既可用在类又可用在属性 -
#[Attribute(Attribute::TARGET_CLASS)]适用于#[Table]这类只修饰类的元数据 - 漏掉
use Attribute;会导致ParseError: syntax error - PHP 8.0 不支持
Attribute::IS_REPEATABLE，若需同一属性多次使用（如多个索引），得升到 8.1+
读取 Attributes 必须用 ReflectionClass::getAttributes()
很多人误以为 getDocComment() 还能拿到 Attributes 内容——不能。#[...] 不是注释，是语法节点，必须走反射 API。而且要注意：反射返回的是 ReflectionAttribute 对象，不是原始实例。
- 获取类上的
#[Table]：(new ReflectionClass(User::class))->getAttributes(Table::class)[0]->newInstance() - 获取属性上的
#[Column]：$prop->getAttributes(Column::class)，其中$prop是ReflectionProperty -
newInstance()会触发构造函数执行，如果构造参数有类型约束（如public string $type），传参错误会抛出ReflectionException - 不要用
getAttributes()不带参数全量获取再手动过滤——性能差，且易漏掉重复标记
Column 属性的参数设计要兼顾 ORM 实际需求
一个 #[Column] 如果只接受 string $name，基本没法落地。真实 ORM 需要识别主键、是否自增、类型、长度、默认值、是否为空等。这些都得靠构造参数+属性公开字段暴露出来。
立即学习“PHP免费学习笔记（深入）”；
- 推荐写法：
public function __construct(public string $name, public string $type = 'string', public bool $primary = false, public bool $autoIncrement = false, public mixed $default = null) - 避免把逻辑塞进构造函数（比如自动转
int类型为integer字符串），保持纯数据载体职责 - 如果需要运行时计算（如生成 SQL 类型字符串），单独抽成方法，不要在
__construct里做 - 注意
mixed $default在 PHP 8.0 中不被允许，得用?string或string|null等具体类型替代
最常被跳过的一步：没在 Composer autoloader 或框架服务中注册 Attribute 类的自动加载，导致反射时找不到类名，报 ReflectionException: Class XXX does not exist。Attributes 不是“写完就能用”，它们是普通类，必须能被自动加载器识别——这点比 DocBlock 注解更严格，也更可靠。
