Qt单例的优雅实现

Q_GLOBAL_STATIC 是 Qt 框架中定义的一个宏，用于方便、安全地创建全局静态对象（通常是单例）。它解决了 C++ 中传统全局静态变量常见的两个问题：

静态初始化顺序问题：不同编译单元中的全局对象初始化顺序不确定，可能相互依赖导致崩溃。
线程安全性：传统局部静态变量（C++11 后局部静态是线程安全的，但全局非局部静态无此保证）在多线程环境下首次初始化可能有竞争。

基本用法

cpp 复制代码

// 定义一个类
class MyGlobal {
public:
    void doSomething() { ... }
};

// 使用 Q_GLOBAL_STATIC 声明全局访问点
Q_GLOBAL_STATIC(MyGlobal, globalMyGlobal)

// 使用方式
int main() {
    // 第一次调用时自动创建对象（线程安全）
    globalMyGlobal()->doSomething();
    // 也可以检查是否已被销毁
    if (globalMyGlobal.isDestroyed()) {
        // 注意：程序结束时对象会被销毁，之后不应再访问
    }
    return 0;
}

宏展开后提供的能力

假设 Q_GLOBAL_STATIC(Type, VariableName) 展开后，会生成一个名为 VariableName 的全局对象，它提供：

operator->() 和 operator*()：访问全局实例，第一次访问时自动初始化。
isDestroyed()：检查全局对象是否已经被销毁（通常在 Q_COREAPP_DESTRUCTION 之后）。
exists()：检查对象是否已创建（未销毁）。
内部使用 QBasicMutex 和双重检查锁确保线程安全的延迟初始化。

关键特性

线程安全的惰性初始化：只有第一次被使用时才创建对象，且所有线程安全。
自动销毁 ：在 QCoreApplication 析构后，Q_GLOBAL_STATIC 会注册一个清理函数，自动销毁全局对象（按构造的反序）。这样可以避免内存泄漏，也避免了手动管理析构时机。
不依赖静态初始化：因为不是普通的全局对象，没有初始化顺序问题。
轻量级 ：相比 QAtomicPointer 手动实现，代码简洁安全。

与普通静态局部变量的对比

C++11 允许函数内静态局部变量线程安全初始化，例如：

cpp 复制代码

MyGlobal& getMyGlobal() {
    static MyGlobal instance;
    return instance;
}

这种写法也是线程安全的，而且更简单。但 Q_GLOBAL_STATIC 额外提供：

更明确的生命周期控制：可以检测对象是否已被销毁。
全局访问的语法更自然 （globalMyGlobal()->doSomething() vs getMyGlobal().doSomething()）。
在 Qt 自身源码中大量使用 （例如 qApp、QCoreApplication::self 的实现），与 Qt 的应用程序生命周期紧密集成。

注意事项

使用时加括号 ：globalMyGlobal() 返回指针，因此需要用 -> 或先解引用。不能写成 globalMyGlobal.doSomething()。
不要手动 delete：由 Qt 内部自动销毁，手动删除会导致双重销毁。
适用于全局单例，但不适用于需要参数构造的对象（只能无参构造）。
在多线程程序结束时 ：如果某个线程在 QCoreApplication 销毁后还尝试访问该全局对象，isDestroyed() 即可被用来避免崩溃。但最佳实践是在主事件循环结束后不再访问。
头文件中使用 ：通常将 Q_GLOBAL_STATIC 放在 .cpp 文件或头文件（但注意多重定义问题）。Qt 推荐放在 .cpp 中，如果要放头文件，需要用 extern 或 Q_GLOBAL_STATIC_WITH_ARGS（但不太常见）。

带参数的版本

如果需要传参构造，可以使用 Q_GLOBAL_STATIC_WITH_ARGS(Type, VariableName, (arg1, arg2))，例如：

cpp 复制代码

Q_GLOBAL_STATIC_WITH_ARGS(QString, myString, ("Hello"))

总结

Q_GLOBAL_STATIC 是 Qt 中实现全局单例的推荐工具，特别适合在 Qt 应用程序或库中需要延迟初始化、线程安全且无初始化顺序依赖的全局资源。它与 Qt 的对象树和应用程序生命周期深度集成，比裸写的全局静态变量更安全可靠。如果你的项目不使用 Qt，C++11 的函数内静态局部变量已足够好；但在 Qt 代码中，Q_GLOBAL_STATIC 是习惯用法。