qpropertyanimation 必须作用于 qobject 派生类的 q_property 声明属性，且需 settargetobject 和 setpropertyname 在 start() 前完成；属性名大小写敏感、类型必须严格匹配；推荐 new 创建并设为目标对象子对象以自动管理生命周期。
QPropertyAnimation 必须作用于 QObject 的可写属性
直接对普通变量或非 QObject 派生对象调用 QPropertyAnimation 会静默失败——动画不启动、不报错、也不触发 valueChanged，因为底层依赖元对象系统。Qt 只能通过 QMetaProperty 访问带 Q_PROPERTY 声明的属性。
- 确保目标对象继承自
QObject（如QWidget、QGraphicsItem），且已调用Q_OBJECT宏 - 要动画的字段必须声明为
Q_PROPERTY，并提供WRITE函数（读函数READ非必需，但调试时很有用） - 常见误操作：试图动画
std::vector成员、裸指针、或未注册到元对象系统的结构体字段
setTargetObject 和 setPropertyName 必须在 start() 前完成
QPropertyAnimation 不会在运行时动态检查属性是否存在；它只在 start() 时一次性解析 setPropertyName 字符串。如果顺序错乱，比如先 start() 再 setTargetObject，动画会立即结束，state() 返回 QAbstractAnimation::Stopped，且无任何提示。
- 正确顺序：
animation->setTargetObject(obj)→animation->setPropertyName("geometry")→animation->setStartValue(...)→animation->setEndValue(...)→animation->start() - 属性名是字符串字面量，大小写敏感，不能带空格或括号，例如
"pos"正确，"position"或"Pos"错误（除非类里真这么声明） - Qt 内置控件常用属性：
"geometry"、"pos"、"size"、"opacity"、"rotation"
动画值类型必须与属性类型严格匹配
Qt 使用元类型系统做类型擦除，setStartValue 和 setEndValue 传入的值类型必须和属性声明的类型一致，否则运行时报 QMetaProperty::write: Unable to write 错误，动画卡在初始状态。
- 例如动画
QWidget::geometry，必须用QRect，不能用QPoint或QSize - 动画
QWidget::opacity必须用qreal（即double），传int会隐式转换失败（尤其在 Qt6 中更严格） - 自定义属性若为
QColor，起止值也得是QColor；若为int，就不能传QString或bool
QPropertyAnimation 默认不自动删除，需手动管理生命周期
动画对象创建后默认 parent 为 nullptr，start() 后不会自动销毁。如果用栈分配或忘记 deleteLater()，可能造成悬空指针或内存泄漏；如果绑定到父对象（如传入 new QPropertyAnimation(this)），又可能因父对象提前析构导致崩溃。
- 推荐做法：用
new QPropertyAnimation(obj)，把动画设为目标对象的子对象（obj是QObject*），这样目标销毁时动画自动清理 - 若需独立生命周期，用
animation->deleteLater()在finished()信号里触发 - 避免栈上创建：
QPropertyAnimation anim;→anim.start()→ 函数返回后对象析构，动画中断且可能 crash
最易被忽略的是属性类型匹配和生命周期绑定——前者导致无声失败，后者引发偶发崩溃，调试时往往绕半天才想到查这两点。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
