링커 오류(Linker Error)는 컴파일 후 링크 단계에서 발생하는 오류이다.

C++ 프로그램을 빌드할 때는 컴파일 단계와 링크 단계가 있다.

• 컴파일 단계:
  • 각 소스 파일을 개별적으로 기계어 코드(오브젝트 파일 .o 또는 .obj) 로 변환
  • 문법 오류(Syntax Error)나 타입 불일치 등의 문제가 발생할 수 있음
• 링크 단계:
  • 컴파일된 여러 개의 오브젝트 파일(.o 또는 .obj)과 라이브러리를 하나의 실행 파일(.exe 또는 a.out)로 합치는 과정
  • 이 단계에서 필요한 함수나 변수가 정의되지 않았거나, 다중 정의된 경우 링크 오류 발생

링크 오류의 원인

(1) 정의되지 않은 함수/변수 참조 (undefined reference)

// header.h
class Test {
public:
    void show();  // 선언만 있고 정의 없음
};

// main.cpp
#include <iostream>
#include "header.h"

int main() {
    Test t;
    t.show();  // show() 정의가 없으므로 링크 오류 발생
    return 0;
}

(2) 다중 정의 (multiple definition)

// file1.cpp
int globalVar = 10; // 전역 변수 정의

// file2.cpp
int globalVar = 20; // 중복 정의 (링크 오류 발생)

(3) 라이브러리 누락 (undefined reference to function)

#include <math.h>

int main() {
    double result = sqrt(16);  // `-lm` 옵션 없이 빌드하면 링크 오류 발생
    return 0;
}

g++ main.cpp -o main -lm

결과

• 컴파일(g++ main.cpp)은 성공해도, 실행 파일(./a.out)이 생성되지 않음
• 오류 메시지는 보통 undefined reference 또는 multiple definition 같은 형태로 나타남

/usr/bin/ld: /tmp/ccXXXX.o: in function `main':
main.cpp:(.text+0x15): undefined reference to `Test::show()'
collect2: error: ld returned 1 exit status