单例模式翻译单元困惑：多CPP文件包含头文件会生成多实例吗？

你的ContainerTest.h中的单例实现 #

class ContainerTest { 
private: 
    ContainerTest() { 
        test = InitializeTest(); 
    } 
    ContainerTest(const ContainerTest&) = delete; 
    ContainerTest(ContainerTest&&) = delete; 
    ContainerTest& operator=(const ContainerTest&) = delete; 
    ContainerTest& operator=(ContainerTest&&) = delete; 
public: 
    std::vector<uint32_t> test; 
    static ContainerTest& GetInstance() { 
        static ContainerTest rhc; 
        return rhc; 
    } 
};

核心疑问解答：会生成一个还是多个实例？ #

放心，整个程序中只会存在一个ContainerTest实例，哪怕A.cpp和B.cpp都包含了这个头文件，调用GetInstance()拿到的都是同一个对象。

原因很简单，你的写法是C里公认的「安全单例」实现，核心依赖两个C标准特性：

• 函数内静态局部变量的初始化规则：根据C++11及以后的标准，函数中的静态局部变量只会在第一次调用该函数时完成初始化，并且整个程序生命周期内只会初始化一次。哪怕多个线程同时触发调用，编译器也会自动生成线程同步的代码，保证初始化的安全性。
• inline函数的静态变量共享规则：因为GetInstance()是在类内部直接定义的，默认属于inline函数。C++标准明确要求，所有翻译单元（也就是每个.cpp编译后的目标文件）中的同一个inline函数，其内部的静态变量必须是同一个实体，不会因为每个.cpp单独编译就生成多个副本。

所以不管多少个.cpp文件调用这个单例，最终都只会有一个ContainerTest实例存在。

额外补充：如果是其他易出问题的单例实现，如何避免多实例？ #

虽然你的当前写法完全没问题，但如果是一些老旧的单例实现方式（比如把实例作为类的静态成员变量），确实可能因为不当操作导致多实例。如果遇到这种情况，可以用这些方法规避：

• 优先改用你现在这种「函数内静态局部变量」的写法，这是现代C++最推荐的单例实现，天然解决多实例和线程安全问题，写法还简洁。
• 如果一定要用类静态成员变量的方式，必须确保这个静态成员只在一个.cpp文件中定义，其他.cpp只通过头文件的声明来访问，绝对不能在多个.cpp里重复定义。
• 给头文件加上正确的头保护（比如#pragma once或者#ifndef CONTAINER_TEST_H #define CONTAINER_TEST_H ... #endif），这能避免头文件被重复包含导致的编译错误，虽然不直接解决多实例问题，但能减少一些潜在的编译层面的隐患。

内容的提问来源于stack exchange，提问作者Bob Dole