Ошибка "Undefined reference to vtable" в C++: причины и решение

Что такое vtable и почему возникает ошибка?

vtable (виртуальная таблица) — это механизм, который компилятор C++ использует для поддержки динамического полиморфизма. Когда класс содержит виртуальные функции (в том числе чисто виртуальные), компилятор генерирует для него таблицу, содержащую указатели на реализации этих функций. Эта таблица должна быть определена ровно один раз во всём проекте.

Ошибка "undefined reference to vtable for Shape" означает, что линковщик не может найти определение vtable для класса Shape. Это происходит, когда компилятор не может сгенерировать vtable, потому что не видит реализации всех виртуальных функций класса.

Корень проблемы в вашем коде

В вашем примере класс Circle наследует чисто виртуальную функцию area() из Shape. Вы объявили double area() override; в circle.h, но забыли реализовать её в circle.cpp. Из-за этого:

• Класс Circle остаётся абстрактным (нельзя создать его экземпляр).
• Компилятор не может сгенерировать vtable для Circle, так как одна из виртуальных функций не имеет тела.
• Линковщик ищет vtable для Shape (как базового класса) и для Circle, но не находит полного определения.

Как исправить?

Добавьте реализацию area() в circle.cpp:

// circle.cpp
#include "circle.h"
#include <cmath> // для M_PI

Circle::Circle(double r) : radius(r) {}

double Circle::area() {
    return M_PI * radius * radius; // площадь круга
}

После этого компиляция должна пройти успешно.

Дополнительные причины ошибки

Ошибка "undefined reference to vtable" может возникать и в других случаях:

• Отсутствие реализации деструктора — если вы объявили виртуальный деструктор, но не определили его тело (даже пустое).
• Inline-функции в .h без определения — если виртуальная функция объявлена как inline в заголовочном файле, но не реализована.
• Неправильная линковка — вы не включили все .cpp файлы в сборку. Например, если shape.cpp не добавлен в команду компиляции, а в нём должен быть деструктор.
• Проблемы с экспортом/импортом DLL — в Windows при использовании __declspec(dllexport) и __declspec(dllimport) нужно явно указывать виртуальные функции.

Как отлаживать?

Если ошибка остаётся, попробуйте:

• Проверить, что все виртуальные функции имеют реализацию.
• Использовать флаг -Wall -Wextra при компиляции — компилятор может предупредить о неопределённых функциях.
• Временно сделать класс Shape неабстрактным (добавить пустую реализацию area()), чтобы проверить, исчезнет ли ошибка.

Пример правильной структуры для вашего проекта:

// shape.h
#ifndef SHAPE_H
#define SHAPE_H
class Shape {
public:
    virtual double area() = 0;
    virtual ~Shape() {} // реализация прямо в заголовке
};
#endif

// circle.h
#ifndef CIRCLE_H
#define CIRCLE_H
#include "shape.h"
class Circle : public Shape {
public:
    Circle(double r);
    double area() override;
private:
    double radius;
};
#endif

// circle.cpp
#include "circle.h"
Circle::Circle(double r) : radius(r) {}
double Circle::area() { return 3.14159 * radius * radius; }

// main.cpp
#include "circle.h"
int main() {
    Circle c(5.0);
    return 0;
}

Компиляция: g++ main.cpp circle.cpp -o prog

Помните: каждая чисто виртуальная функция должна быть переопределена и реализована в производном классе, иначе класс остаётся абстрактным и его нельзя инстанцировать.

class Shape {
public:
    virtual ~Shape(); // объявлен, но не определён
};