[2026] C++ Extern Linkage | 외부 연결 가이드

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

이 글의 핵심

C++ Extern Linkage - 외부 연결 가이드. C++ Extern Linkage의 내부 연결 vs 외부 연결, `extern C` 심화, 실전 라이브러리 설계 팁를 실전 코드와 함께 설명합니다.

들어가며

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 기본

개념

아래 코드는 cpp를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

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

기본 사용법

다음은 cpp를 활용한 상세한 구현 코드입니다. 필요한 모듈을 import하고. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

// 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: 전역 설정

다음은 cpp를 활용한 상세한 구현 코드입니다. 필요한 모듈을 import하고. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

// 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: 함수 선언

다음은 cpp를 활용한 상세한 구현 코드입니다. 필요한 모듈을 import하고. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

// 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”

다음은 cpp를 활용한 상세한 구현 코드입니다. 필요한 모듈을 import하고. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

// 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

비교

아래 코드는 cpp를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

// extern (외부 연결)
extern int globalVar;
// static (내부 연결)
static int localVar;

예제

아래 코드는 cpp를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

// 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: 중복 정의

아래 코드는 cpp를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

// ❌ 헤더에 정의
// header.h
int globalVar = 10;
// ✅ 헤더에 선언, 소스에 정의
// header.h
extern int globalVar;
// source.cpp
int globalVar = 10;

문제 2: 초기화 순서

아래 코드는 cpp를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

// 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

아래 코드는 cpp를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

// ❌ const는 기본 internal linkage
// header.h
const int MAX = 100;
// ✅ extern 명시
// header.h
extern const int MAX;
// source.cpp
const int MAX = 100;

문제 4: 네임스페이스

아래 코드는 cpp를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

// ❌ 전역 네임스페이스 오염
extern int counter;
// ✅ 네임스페이스 사용
namespace MyApp {
    extern int counter;
}

5. extern template

명시적 인스턴스화

다음은 cpp를 활용한 상세한 구현 코드입니다. 필요한 모듈을 import하고, 클래스를 정의하여 데이터와 기능을 캡슐화하며. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

// 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: 로거 시스템

다음은 cpp를 활용한 상세한 구현 코드입니다. 필요한 모듈을 import하고, 조건문으로 분기 처리를 수행합니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

// 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 연동

다음 단계

관련 글

... 996 lines not shown ... Token usage: 63706/1000000; 936294 remaining Start-Sleep -Seconds 3