C++ Extern Linkage | "외부 연결" 가이드

· 15분 읽기 · 수정 중급 튜토리얼
C++ Extern Linkage | "외부 연결" 가이드

이 글의 핵심

C++ Extern Linkage에 대한 실전 가이드입니다.

들어가며

C++의 extern은 여러 파일에서 전역 변수나 함수를 공유할 때 사용하는 키워드입니다. 링키지(linkage) 개념을 이해하는 데 핵심적입니다.

내부 연결 vs 외부 연결

개념의미대표적인 경우
외부 연결(external linkage)다른 번역 단위(.cpp)에서 같은 이름이 하나의 엔티티를 가리킴파일 범위의 비-static 함수, extern 전역 변수 선언/정의
내부 연결(internal linkage)이름이 해당 번역 단위 안에서만 보임static 파일 범위 변수/함수, const 객체의 기본(구버전 규칙과 주의), 익명 네임스페이스 안의 이름
연결 없음지역 변수, 클래스 멤버 등링커 수준이 아닌 스코프 규칙으로만 해석

실무 포인트: “헤더에 넣으면 ODR 위반인가?”는 대개 연결과 inline 규칙 문제입니다. 함수는 inline 정의를 헤더에 둘 수 있지만, 전역 변수의 정의는 보통 한 .cpp에만 둡니다.

extern "C" 심화

C++는 이름 장식(name mangling)으로 오버로드를 구분합니다. C ABI는 그렇지 않으므로, C 라이브러리 심볼과 링크하려면 extern "C" 블록으로 “C 링키지”를 명시합니다.

  • 포인터 타입: extern "C" 함수에 C++에서 만든 콜백을 넘길 때는 **콜백도 extern "C"**로 맞추거나, 바인딩 규칙을 문서화해야 합니다.
  • 오버로드 불가: C 링키지 함수 이름은 번역 단위당 하나입니다.
  • 헤더 관용: #ifdef __cplusplus로 감싸 공통 헤더를 C와 C++에서 같이 씁니다(아래 예제 3과 동일 패턴).
extern "C" int plugin_init(void* ctx);  // 심볼명이 C 규칙으로 노출

헤더 가드·#pragma once와의 관계

헤더 가드(#ifndef / #define)나 **#pragma once**는 전처리 단계에서 같은 헤더가 같은 번역 단위에 두 번 포함되는 것을 막습니다. 링키지와는 층이 다릅니다: 가드는 “중복 파싱 방지”, 링키지는 “링커가 심볼을 어떻게 합치나”입니다.

다만 실무에서는 다음을 한 세트로 생각합니다.

  1. 선언은 헤더에 여러 번 포함돼도 안전해야 함 → #pragma once + 선언만.
  2. 정의는 한 번만 → .cpp에 두거나 inline/constexpr 등 규칙 준수.
  3. extern 전역 변수: 헤더에는 extern int x;, 소스 한 곳에 int x = 0;.

즉 “가드가 링키지를 바꾼다”가 아니라, 가드 덕분에 헤더를 안전하게 여러 곳에서 include할 수 있어 ODR을 지키기 쉬워집니다.

실전 라이브러리 설계 팁

  1. 공개 API는 네임스페이스로 감싸고, 전역 extern 남발을 피합니다.
  2. 구현 세부는 내부 연결(static, 익명 네임스페이스) 또는 detail 네임스페이스에 둡니다.
  3. C API 노출이 필요하면 extern "C" + 안정적인 ABI 문서(호출 규약, 스레드 안전성)를 제공합니다.
  4. 모듈(C++20) 또는 명확한 include 계층으로 “헤더에서 무엇이 노출되는지”를 줄입니다.

1. extern 기본

개념

// file1.cpp
int globalVar = 10;

// file2.cpp
extern int globalVar;
int x = globalVar;

기본 사용법

// globals.h
extern int counter;
extern void increment();

// globals.cpp
#include "globals.h"
#include <iostream>

int counter = 0;

void increment() {
    counter++;
}

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

int main() {
    increment();
    std::cout << counter << std::endl;  // 1
}

2. 실전 예제

예제 1: 전역 설정

// config.h
#ifndef CONFIG_H
#define CONFIG_H

#include <string>

extern int maxConnections;
extern std::string serverName;

#endif

// config.cpp
#include "config.h"

int maxConnections = 100;
std::string serverName = "MyServer";

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

int main() {
    std::cout << "Max: " << maxConnections << std::endl;
    std::cout << "Server: " << serverName << std::endl;
}

예제 2: 함수 선언

// utils.h
#ifndef UTILS_H
#define UTILS_H

#include <string>

extern void printMessage(const std::string& msg);
extern int calculate(int a, int b);

#endif

// utils.cpp
#include "utils.h"
#include <iostream>

void printMessage(const std::string& msg) {
    std::cout << msg << std::endl;
}

int calculate(int a, int b) {
    return a + b;
}

// main.cpp
#include "utils.h"

int main() {
    printMessage("Hello");
    int result = calculate(5, 3);
    printMessage(std::to_string(result));
}

예제 3: extern “C”

// c_library.h
#ifdef __cplusplus
extern "C" {
#endif

void c_function();
int c_calculate(int a, int b);

#ifdef __cplusplus
}
#endif

// c_library.c
#include "c_library.h"
#include <stdio.h>

void c_function() {
    printf("C function\n");
}

int c_calculate(int a, int b) {
    return a + b;
}

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

int main() {
    c_function();
    int result = c_calculate(5, 3);
    std::cout << result << std::endl;
}

3. extern vs static

비교

// extern (외부 연결)
extern int globalVar;

// static (내부 연결)
static int localVar;

예제

// file1.cpp
int externVar = 10;
static int staticVar = 20;

// file2.cpp
extern int externVar;
// extern int staticVar;  // 에러: 접근 불가

int main() {
    std::cout << externVar << std::endl;  // 10
}

4. 자주 발생하는 문제

문제 1: 중복 정의

// ❌ 헤더에 정의
// header.h
int globalVar = 10;

// ✅ 헤더에 선언, 소스에 정의
// header.h
extern int globalVar;

// source.cpp
int globalVar = 10;

문제 2: 초기화 순서

// file1.cpp
int a = 10;

// file2.cpp
extern int a;
int b = a * 2;

// ✅ 함수 내 static
int& getA() {
    static int a = 10;
    return a;
}

int b = getA() * 2;

문제 3: const와 extern

// ❌ const는 기본 internal linkage
// header.h
const int MAX = 100;

// ✅ extern 명시
// header.h
extern const int MAX;

// source.cpp
const int MAX = 100;

문제 4: 네임스페이스

// ❌ 전역 네임스페이스 오염
extern int counter;

// ✅ 네임스페이스 사용
namespace MyApp {
    extern int counter;
}

5. extern template

명시적 인스턴스화

// header.h
template<typename T>
class MyClass {
public:
    void print(T value);
};

extern template class MyClass<int>;

// source.cpp
template class MyClass<int>;

// main.cpp
#include "header.h"

int main() {
    MyClass<int> obj;
}

6. 실전 예제

예제 1: 로거 시스템

// logger.h
#ifndef LOGGER_H
#define LOGGER_H

#include <string>

extern int logLevel;
extern void log(const std::string& message);

#endif

// logger.cpp
#include "logger.h"
#include <iostream>

int logLevel = 1;

void log(const std::string& message) {
    if (logLevel > 0) {
        std::cout << "[LOG] " << message << std::endl;
    }
}

// main.cpp
#include "logger.h"

int main() {
    logLevel = 2;
    log("Application started");
}

정리

핵심 요약

  1. extern: 외부 연결
  2. 선언 vs 정의: 헤더에 선언, 소스에 정의
  3. extern “C”: C 링키지
  4. const: extern 명시 필요
  5. static: 내부 연결

extern vs static 비교

특성externstatic
연결외부내부
다른 파일 접근OX
중복 정의XO
용도전역 공유파일 내부

실전 팁

  • 헤더에는 선언만 (extern)
  • 소스에는 정의 (초기화)
  • const는 extern 명시
  • 네임스페이스 사용 권장
  • extern "C"로 C 연동

다음 단계

  • C++ Linkage와 Storage
  • C++ One Definition Rule
  • C++ Static Members

관련 글

  • C++ Linkage와 Storage |
  • C++ Zero Initialization |
  • 배열과 리스트 | 코딩 테스트 필수 자료구조 완벽 정리
  • C++ Adapter Pattern 완벽 가이드 | 인터페이스 변환과 호환성
  • C++ ADL |