本章重要 API 函数#

💡 Tips：Qt6 废弃了老旧的 qrand()/qsrand()（全局、线程不安全、质量差），统一用 QRandomGenerator。bounded(0,10) 比 generate()%10 更均匀（避免取模偏差）。另外本源码 new QRandomGenerator() 后没有 delete 也没有父对象——它是裸堆对象、不进对象树（qt08），会造成内存泄漏，生产代码应复用 QRandomGenerator::global() 单例而非 new。

本章目录#

点击条目可跳转到对应小节。

学习前后依赖#

💡 Tips：本篇是”动画/随机移动”的引擎原理篇——qt12 源码演示了随机数发生器与元对象属性读写这两个”零件”，而把它们真正动起来需要 QTimer（定时触发）配合重绘。所以必须先懂 qt08 的对象树（Monster 归属）与元对象系统，下一步才能接 qt13 信号槽把 QTimer 的 timeout 连到 update()。

1. 概述#

很多 GUI 效果——游戏里怪物随机游走、仪表盘指针跳动、验证码图片抖动、粒子飘动——本质都是”定时 + 随机”：每隔一小段时间，用随机数改变某个状态（位置、血量、角度），再刷新界面。qt12 工程名 radom（random）正指向这个目标，其源码用两块核心能力搭好地基：

1. QRandomGenerator：Qt6 的高质量随机数发生器，基于系统熵源，替代了老旧且线程不安全的 qrand()。
2. QObject 元对象系统（Meta-Object System）：通过 metaObject() 在运行时”反射”一个 QObject 的属性名、类型，并动态 read/write——这让”随机数改变怪物属性”可以写得非常通用（一个函数能操作任意属性）。

monster.h/cpp 定义了 Monster : QObject，hello.cpp 里 test_01 跑随机数、test_02 用元对象系统查看并尝试修改 Monster 的 health/mana。至于”定时器动画”，标准做法是用 QTimer 周期性触发——它会在 Q&A 与下一步里重点展开，因为它是把”随机数 + 属性”真正变成”动画”的那根发条。

💡 Tips：概述里最该记住的一句话——“动画 = QTimer 定时发信号 + 槽里用 QRandomGenerator 改属性 + 重绘；qt12 把前两个零件给你了，QTimer 是把它们拧成钟表的螺丝。” 源码本身没用 QTimer，但它是这主题绕不开的下一步。

2. 核心概念 / 原理#

3. 随机数与元对象属性的协作#

下面用 flowchart 表示”怪物随机移动/掉血”的理想数据流（随机数 → 元属性 → 重绘），并标注本源码的实际落点：

黄框 QTimer 是理想动画的”发条”（本源码未接，作为延伸）；蓝框 write 是元对象改属性的关键。虚线表示本源码的实际行为：test_01 只打印随机数，lost() 因缺 Q_PROPERTY 未能真正改属性。

💡 Tips：流程里最关键的箭头是 C -->|存在 Q_PROPERTY| D——元对象读写的前提是属性被 Q_PROPERTY 声明。若没有它（如本源码），indexOfProperty 返回 -1，整个”动态改属性”链条断裂。记住：想让 read/write 生效，先给成员加 Q_PROPERTY。

4. 核心代码解析#

qt12_radom/hello.cpp 与 monster.h/cpp 逐段拆解：

1
void test_01() {
2
    QRandomGenerator *gen = new QRandomGenerator();
3
    gen->seed(QDateTime::currentSecsSinceEpoch());
4
    for(int i=0;i<5;i++) {
5
        // qDebug() << gen->bounded(0,10);
6
        qDebug() << gen->generate();     // 打印 5 个 32 位随机数
7
    }
8
}

• new QRandomGenerator() 堆上构造；seed(epoch) 用当前秒级时间戳播种（Qt6 其实默认已熵源充足，seed 多用于可复现测试）。循环打印 generate() 的 quint32。注意：gen 无父、无 delete → 内存泄漏（见踩坑）。
• 注释掉的 bounded(0,10) 才是更常用、更均匀的区间取法；实际运行打印的是 generate() 原始大数。

1
void my_show(QObject *obj) {
2
    auto meta = obj->metaObject();
3
    qDebug() << "count "<< meta->propertyCount();
4
    for(int i=0;i<meta->propertyCount();i++) {
5
        auto property = meta->property(i);
6
        qDebug() << property.name() << " " << property.typeName();
7
    }
8
}
9

10
void lost(QObject *obj, const char *propertyName) {
11
    auto meta = obj->metaObject();
12
    int index = meta->indexOfProperty(propertyName);  // 找 "health"
13
    auto property = meta->property(index);
14
    int cur = property.read(obj).toInt();
15
    cur--;
16
    property.write(obj, cur);     // 期望 : 血量 -1
17
}

• my_show(&mon1) 枚举 Monster 的属性。由于 Monster 没声明 Q_OBJECT 属性（除继承的 objectName），propertyCount() 通常只有 1（即 objectName），m_health/m_mana 不会出现。
• lost(&mon1,"health") 里 indexOfProperty("health") 返回 -1（属性不存在），meta->property(-1) 得到无效 QMetaProperty，read 返回默认 QVariant(int 0)，write 写到无效属性被静默忽略——所以血量其实没减。这是源码的真实行为，不是”写错了才这样”。

1
class Monster : public QObject {
2
    Q_OBJECT
3
public:
4
    explicit Monster(QObject *parent = nullptr);
5
    ~Monster();
6
    void show_info() const;
7
private:
8
    int m_health;   // 普通成员, 未用 Q_PROPERTY 声明
9
    int m_mana;
10
};
11

12
// monster.cpp
13
Monster::Monster(QObject *parent) : QObject(parent), m_health(100), m_mana(100) {}
14
void Monster::show_info() const {
15
    std::cout << "hp" << m_health << "    " << " mana" << m_mana << std::endl;
16
}
17
Monster::~Monster() { std::cout << "monster is destroyed" << std::endl; }

• Monster 继承 QObject(parent)，进对象树（qt08），析构打印证明随父销毁。m_health/m_mana 在构造初始化列表设 100。show_info() 直接打印成员——注意它打印的是真实成员变量，不受元对象读写影响，所以 test_02 里即便 lost 调用了，show_info 仍显示 100（因为 write 没真正生效）。

💡 Tips：这段代码藏着的细节——① Q_OBJECT 宏只在”需要信号/槽/属性”时有用；Monster 用了它却没声明 Q_PROPERTY，导致元对象系统拿不到 health；② 若想让 lost 真生效，应改为 Q_PROPERTY(int health READ health WRITE setHealth) 并提供访问器，同时把 m_health 改名为带 getter；③ gen 用 new 却不释放，正确做法是 auto *gen = QRandomGenerator::global(); 直接拿全局单例，零分配。

5. 运行效果 / 验证#

编译运行 qt12_radom（hello.cpp 的 main 调用 test_01()、test_02()）：

• test_01：打印 5 个明显不同的大整数（32 位随机值），每次运行数值都变（因 seed 用时间戳）。
• test_02：my_show(&mon1) 输出属性计数与名称（实际只有 objectName 之类继承属性）；lost 调用后 mon1.show_info() 仍显示 hp100 mana100——证明 lost 没能改到 m_health/m_mana（因缺 Q_PROPERTY）。
• 程序退出时打印 monster is destroyed，证明 Monster 随对象树正常析构。

若把 Monster 加上 Q_PROPERTY(int health ...) 并接 QTimer（见 Q&A 示例），则能看到血量随定时器递减、界面刷新——这才是”随机/定时动画”的完整形态。

💡 Tips：验证时最容易误判”成功”的假象——看到 lost 调用后程序没崩，就以为血量减了。实际 show_info 仍打印 100，因为元对象写的是”不存在的属性”（index=-1），被静默忽略。真验证：给 Monster 加 Q_PROPERTY 后，再跑 lost 应看到血量变化；或用 qDebug() << index 确认 indexOfProperty 不再是 -1。

容易踩坑（注意点）#

• 坑 1：m_health 没声明 Q_PROPERTY 却用元对象读写。现象：lost 调用”成功”但血量不变。原因：indexOfProperty 返回 -1，write 写到无效属性。规避：用 Q_PROPERTY(int health READ ... WRITE ...) 声明，并提供 getter/setter。
• 坑 2：new QRandomGenerator() 不释放。现象：内存泄漏（本源码实写）。原因：它不是 QObject、无父、没 delete。规避：用 QRandomGenerator::global() 单例，或 delete gen。
• 坑 3：用 generate() % n 代替 bounded。现象：轻微分布偏差（尤其 n 不整除 2³²）。原因：取模拒绝采样缺失。规避：一律 bounded(low, high)。
• 坑 4：用已废弃的 qrand()。现象：Qt6 编译告警/行为不一致、线程不安全。原因：qrand 在 Qt6 弃用。规避：统一 QRandomGenerator。
• 坑 5：误以为 metaObject() 能看到所有私有成员。现象：枚举属性时找不到自定义字段。原因：元对象只认 Q_PROPERTY。规避：需要在运行时反射的成员必须 Q_PROPERTY 声明。
• 坑 6：QTimer 不触发 timeout。现象：定时器”不动”。原因：没跑 QCoreApplication::exec() 事件循环，或没 connect(timeout, ...)。规避：确保 exec() 在跑且信号已连接（qt13）。

学习要点总结#

Q&A（常见问题）#

Q1：Qt6 里怎么正确生成 [0,10) 的随机整数？ A1：用 QRandomGenerator::global()->bounded(0, 10)（或 bounded(10) 表示 [0,10)）。不要写 generate() % 10——有取模偏差；也不要用已废弃的 qrand()。示例：

1
#include <QRandomGenerator>
2
int r = QRandomGenerator::global()->bounded(0, 10); // 0..9

Q2：为什么 lost(&mon1,"health") 没让血量减 1？怎么修？ A2：因为 Monster::m_health 是普通成员、没用 Q_PROPERTY 声明，元对象系统里没有名为 health 的属性，indexOfProperty 返回 -1，写操作被忽略。修复：在 monster.h 加 Q_PROPERTY(int health READ health WRITE setHealth) 并提供 int health() const { return m_health; } void setHealth(int v){ m_health=v; }，再让 m_health 通过 getter 暴露。这样 property.write(obj, cur) 才会真正改值。

Q3：本源码没用 QTimer，怎么把它变成”怪物随机移动动画”？ A3：用 QTimer 定时触发，在槽里用随机数改坐标属性并请求重绘。示例骨架：

1
// 在 Monster 或 Widget 中
2
QTimer *t = new QTimer(this);          // this 作父, 随对象树销毁(qt08)
3
connect(t, &QTimer::timeout, this, [this]{
4
    int dx = QRandomGenerator::global()->bounded(-5, 6);
5
    setX(x() + dx);                     // 假设 x 是 Q_PROPERTY
6
    update();                           // 触发重绘(qt20)
7
});
8
t->start(50);                          // 每 50ms 动一次

前提：被改的 x 必须是 Q_PROPERTY，且需 QCoreApplication::exec() 事件循环运行。这正衔接 qt13 信号槽与 qt20 绘图。

Tips（全局速记）#