C++ 類定義與實現分離：因拼寫錯誤導致的鏈接失敗案例分析

C++ 類定義與實現分離：因拼寫錯誤導致的鏈接失敗案例分析

現象：頭文件聲明 void display();，cpp 實現寫成 void dispaly()（少一個 's'），主函數調用 obj.display()，編譯通過但鏈接報錯 unresolved external symbol display。

錯誤本質

• 編譯階段：編譯器只檢查語法與聲明匹配，主函數看到聲明以為有定義，生成目標文件時留下「外部符號引用」。
• 鏈接階段：鏈接器在所有目標文件中尋找 display 的定義，發現只有 dispaly，名稱不匹配，報錯 LNK2019。

修正方法

統一拼寫：

// MyClass.h
class MyClass {
public:
    void display(); // 正確拼寫
};

// MyClass.cpp
#include "MyClass.h"
void MyClass::display() { // 必須與聲明完全一致
    cout << "Hello" << endl;
}

預防技巧

• 使用 IDE 重構/重命名功能（F2 / Refactor → Rename），自動同步聲明與定義。
• 啟用編譯器警告 -Wmissing-declarations (GCC) 或 /W4 (MSVC)。
• 模板類將實現寫在頭文件內，避免鏈接問題。

此類低級錯誤雖簡單，但極易在大型項目中浪費大量調試時間，養成「聲明定義同步」習慣至關重要。