C++单例实现遇LNK2019错误：私有静态外部符号未解析

错误根源 #

• 私有构造函数仅声明未实现：头文件中声明了private: ActionLogger();，但cpp文件未提供该构造函数的具体定义，链接器无法找到对应实现，触发LNK2019错误。
• 实例化类名笔误：new ClassName()写错了类名，应改为new ActionLogger()。
• 类定义结尾遗漏分号：原头文件中类定义末尾缺少分号，会导致编译警告或错误。

修正后的代码 #

头文件（ActionLogger.h）

class ActionLogger
{
public:
    static ActionLogger* getInstance();

private:
    ActionLogger();
    ActionLogger(const ActionLogger& obj) = delete;

    static ActionLogger* _instance;
}; // 补充类定义结尾的分号

cpp文件（ActionLogger.cpp）

#include "ActionLogger.h"

// 初始化静态成员变量，建议用nullptr替代NULL（C++11+规范）
ActionLogger* ActionLogger::_instance = nullptr;

// 实现私有构造函数
ActionLogger::ActionLogger()
{
    // 可在此添加初始化逻辑，比如打开日志文件、初始化配置等
}

ActionLogger* ActionLogger::getInstance()
{
    if (_instance == nullptr)
    {
        _instance = new ActionLogger(); // 修正类名笔误
    }
    return _instance;
}

额外说明 #

上述实现为非线程安全版本，多线程环境下可能创建多个实例。若需线程安全，推荐使用C++11及以上的静态局部变量实现（简洁且原生线程安全）：

线程安全版代码

// 头文件
class ActionLogger
{
public:
    static ActionLogger& getInstance();

private:
    ActionLogger();
    ActionLogger(const ActionLogger&) = delete;
    ActionLogger& operator=(const ActionLogger&) = delete; // 禁止赋值运算符
};

// cpp文件
#include "ActionLogger.h"

ActionLogger::ActionLogger()
{
    // 构造逻辑
}

ActionLogger& ActionLogger::getInstance()
{
    static ActionLogger instance; // C++11+保证局部静态变量初始化线程安全
    return instance;
}

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