如何修复C++链接时缺失`_ZTV8Settings`符号的未定义引用问题

问题根源 #

_ZTV8Settings是Settings类的虚表符号，链接报错的核心原因是：
你的Settings类中所有虚函数只有声明、没有实现，且未将任何虚函数声明为纯虚函数。这种情况下编译器无法生成虚表——虚表需要指向每个虚函数的具体实现地址，但这些函数都没有定义；同时它又不是抽象类，无法强制派生类去补全实现。

具体修复步骤 #

方案1：将Settings改为抽象基类（推荐，适合作为基类被继承的场景） #

如果Settings是用来被其他类继承的基类，把至少一个虚函数声明为纯虚函数（添加=0），使其成为抽象类，虚表会在实现了所有纯虚函数的派生类中生成。示例修改：

/// @brief  The abstract Settings struct
struct Settings {
    /// Saves to persistance
    virtual void saveToPersistance() = 0; // 改为纯虚函数
    /// Loads from persistance
    virtual void loadFromPersistance() = 0;

    /// Marshall all values to make sure we are in range
    virtual void _marshallValues() = 0;

    /// @brief Update settings from the [args] and store to the persistance storage.
    /// Note that the order of the arguments is of great importance, shuffling them 
    /// results in unexpected behaviour.
    /// @param args The list of settings
    /// @param size The number of settings
    virtual void storeSettings(float args[], size_t size) = 0;

    /// @brief Dump data
    /// @param message The message to display in the dump header
    virtual void dump(const char * message) = 0;

    /// @brief Load settings from the persistan storage
    inline void loadSettings() {
        // Load settings
        loadFromPersistance();
    }

    /// @brief Sends the config as a Json SDLTP thru BLE
    virtual void bleSendJson() = 0;
};

之后确保你的派生类（比如ConcreteSettings）实现了所有纯虚函数，再在某个.cpp文件中定义全局对象：

ConcreteSettings settings;

方案2：为Settings的所有虚函数提供实现（适合直接实例化的场景） #

如果需要直接实例化Settings类，要为每个虚函数编写具体实现（哪怕是空实现），这样编译器会为Settings生成虚表。比如在对应的.cpp文件中添加：

void Settings::saveToPersistance() {
    // 空实现或你的具体逻辑
}

void Settings::loadFromPersistance() {
    // 空实现或你的具体逻辑
}

void Settings::_marshallValues() {
    // 空实现或你的具体逻辑
}

void Settings::storeSettings(float args[], size_t size) {
    // 空实现或你的具体逻辑
}

void Settings::dump(const char * message) {
    // 空实现或你的具体逻辑
}

void Settings::bleSendJson() {
    // 空实现或你的具体逻辑
}

然后在某个.cpp文件中正确定义全局对象：

Settings settings;

额外检查 #

• 确保所有引用settings的文件都正确包含了Settings类的头文件，且头文件有正确的包含保护（比如#ifndef）。
• 检查PlatformIO配置，确保所有相关的.cpp文件都被加入编译流程，没有被遗漏。

内容的提问来源于stack exchange，提问作者Stéphane de Luca