링키지(linkage)와 저장 기간(storage duration)의 차이는 무엇인가요?

링키지는 이름이 여러 번역 단위에서 같은 엔티티를 가리키는지에 대한 규칙이고, 저장 기간은 객체가 메모리에 존재하는 시간 범위를 말합니다. 둘은 독립적인 개념이며, 예를 들어 지역 변수는 링키지가 없어도 자동 저장 기간을 가질 수 있습니다.

파일 범위에서 static을 쓰면 링키지에 어떤 영향이 있나요?

전역이나 네임스페이스 범위에서 static을 붙이면 해당 이름은 내부 링키지(internal linkage)를 갖습니다. 같은 이름이 다른 .cpp 파일에 있어도 서로 다른 심볼로 취급되며, 다른 번역 단위에서는 extern으로도 그 이름을 참조할 수 없습니다.

extern 선언은 어떤 경우에 사용하나요?

다른 번역 단위에서 이미 정의된 외부 링키지를 가진 변수나 함수를 이 번역 단위에서 사용하겠다고 알릴 때 씁니다. 정의(definition)는 보통 한 파일에만 두고, 나머지 파일에서는 extern으로 선언(declaration)만 두는 패턴이 흔합니다.

내부 링키지(static 파일 범위)로 선언한 심볼을 다른 소스 파일에서 쓰려면 어떻게 해야 하나요?

직접은 불가능합니다. 내부 링키지는 해당 번역 단위에만 가시적입니다. 공유하려면 static을 제거해 외부 링키지로 만들고, 한 곳에서만 정의한 뒤 필요한 곳에 헤더를 통해 선언하거나, 공용 인터페이스를 별도의 외부 링키지 심볼로 노출하는 방식으로 구조를 바꿉니다.

C++ Linkage와 Storage | '연결과 저장 기간' 가이드

2026년 3월 12일 · 11분 읽기 · 수정 2026년 4월 7일 중급 튜토리얼

이 글의 핵심

C++ Linkage와 Storage: "연결과 저장 기간" 가이드. Linkage 종류·Storage Duration.

Linkage 종류

External Linkage

func 함수의 구현 예제입니다.

// file1.cpp
int globalVar = 10;  // external linkage

void func() {  // external linkage
    cout << globalVar << endl;
}

// file2.cpp
extern int globalVar;  // 선언
extern void func();    // 선언

int main() {
    cout << globalVar << endl;  // 10
    func();
}

Internal Linkage

internalFunc 함수의 구현 예제입니다.

// file1.cpp
static int internalVar = 10;  // internal linkage

static void internalFunc() {  // internal linkage
    cout << internalVar << endl;
}

// file2.cpp
// internalVar와 internalFunc는 접근 불가

No Linkage

void func() {
    int localVar = 10;  // no linkage
    // 이 함수 내에서만 존재
}

Storage Duration

Automatic Storage

void func() {
    int x = 10;  // automatic storage
    // 함수 종료 시 자동 파괴
}

Static Storage

func 함수의 구현 예제입니다.

// 전역 변수
int global = 10;  // static storage

void func() {
    static int counter = 0;  // static storage
    counter++;
    cout << counter << endl;
}

int main() {
    func();  // 1
    func();  // 2
    func();  // 3
}

Thread Storage

#include <thread>

thread_local int threadVar = 0;  // thread storage

void increment() {
    threadVar++;
    cout << "스레드 " << this_thread::get_id() 
         << ": " << threadVar << endl;
}

int main() {
    thread t1(increment);
    thread t2(increment);
    
    t1.join();
    t2.join();
    
    // 각 스레드마다 독립적인 threadVar
}

Dynamic Storage

int* ptr = new int(10);  // dynamic storage
// 명시적 delete 필요
delete ptr;

실전 예시

예시 1: 싱글톤 (static)

class Singleton {
private:
    Singleton() {
        cout << "싱글톤 생성" << endl;
    }
    
public:
    static Singleton& getInstance() {
        static Singleton instance;  // static storage
        return instance;
    }
    
    void doSomething() {
        cout << "작업 수행" << endl;
    }
};

int main() {
    Singleton::getInstance().doSomething();
    Singleton::getInstance().doSomething();
    // 한 번만 생성됨
}

예시 2: 함수 호출 카운터

trackedFunction 함수의 구현 예제입니다.

void trackedFunction() {
    static int callCount = 0;  // static storage
    callCount++;
    
    cout << "호출 횟수: " << callCount << endl;
}

int main() {
    trackedFunction();  // 1
    trackedFunction();  // 2
    trackedFunction();  // 3
}

예시 3: 스레드별 캐시

#include <thread>
#include <vector>

thread_local vector<int> cache;

void processData(int data) {
    cache.push_back(data);
    
    cout << "스레드 " << this_thread::get_id() 
         << " 캐시 크기: " << cache.size() << endl;
}

int main() {
    thread t1( {
        for (int i = 0; i < 5; i++) {
            processData(i);
        }
    });
    
    thread t2( {
        for (int i = 0; i < 3; i++) {
            processData(i);
        }
    });
    
    t1.join();
    t2.join();
    
    // 각 스레드마다 독립적인 cache
}

예시 4: 익명 네임스페이스

internalFunc 함수의 구현 예제입니다.

// file1.cpp
namespace {
    int internalVar = 10;  // internal linkage
    
    void internalFunc() {
        cout << internalVar << endl;
    }
}

void publicFunc() {
    internalFunc();  // OK
}

// file2.cpp
// internalVar와 internalFunc 접근 불가

extern 사용법

변수 선언

main 함수의 구현 예제입니다.

// globals.cpp
int globalCounter = 0;  // 정의

// main.cpp
extern int globalCounter;  // 선언

int main() {
    globalCounter++;
    cout << globalCounter << endl;
}

const와 extern

main 함수의 구현 예제입니다.

// file1.cpp
extern const int value = 10;  // external linkage

// file2.cpp
extern const int value;  // 선언

int main() {
    cout << value << endl;  // 10
}

템플릿 extern

func 함수의 구현 예제입니다.

// template.h
template<typename T>
void func(T value);

// template.cpp
template<typename T>
void func(T value) {
    cout << value << endl;
}

// 명시적 인스턴스화
template void func<int>(int);

// main.cpp
extern template void func<int>(int);  // 선언

int main() {
    func(10);
}

static 키워드

함수 내 static

func 함수의 구현 예제입니다.

void func() {
    static int x = 0;  // 한 번만 초기화
    x++;
    cout << x << endl;
}

int main() {
    func();  // 1
    func();  // 2
    func();  // 3
}

클래스 static 멤버

class Counter {
private:
    static int count;  // 선언
    
public:
    Counter() { count++; }
    static int getCount() { return count; }
};

int Counter::count = 0;  // 정의

int main() {
    Counter c1, c2, c3;
    cout << Counter::getCount() << endl;  // 3
}

자주 발생하는 문제

문제 1: static 초기화 순서

compute 함수의 구현 예제입니다.

// file1.cpp
int x = compute();  // 먼저?

// file2.cpp
int y = compute();  // 먼저?

// 순서 미정의!

// ✅ 함수 내 static 사용
int& getX() {
    static int x = compute();
    return x;
}

문제 2: extern 중복 정의

C/C++ 예제 코드입니다.

// ❌ 링크 에러
// file1.cpp
int value = 10;

// file2.cpp
int value = 20;  // 중복 정의!

// ✅ 한 곳에서만 정의
// file1.cpp
int value = 10;

// file2.cpp
extern int value;

문제 3: thread_local 초기화

// ❌ 복잡한 초기화
thread_local vector<int> data = expensiveInit();  // 매 스레드마다

// ✅ 지연 초기화
thread_local unique_ptr<vector<int>> data;

void ensureInit() {
    if (!data) {
        data = make_unique<vector<int>>(expensiveInit());
    }
}

초기화 순서

정적 초기화

// 컴파일 타임 또는 프로그램 시작 전
int x = 10;
const int y = 20;

동적 초기화

C/C++ 예제 코드입니다.

// 런타임
int x = compute();

// 순서: 같은 파일 내에서는 순서 보장
int a = 10;
int b = a + 5;  // OK

함수 내 static

compute 함수의 구현 예제입니다.

int& getValue() {
    static int value = compute();  // 첫 호출 시 초기화
    return value;
}

// 스레드 안전 (C++11)

FAQ

Q1: extern과 static의 차이는?

extern: 다른 파일에서 접근 가능
static: 현재 파일에서만 접근 가능

Q2: thread_local은 언제 사용하나요?

스레드별 캐시
스레드별 상태
난수 생성기

Q3: static 초기화 순서 문제는?

A: 함수 내 static을 사용하면 해결됩니다.

Q4: extern “C”는 왜 필요한가요?

A: C 코드와 링크하기 위해 name mangling을 방지합니다.

Q5: 전역 변수는 피해야 하나요?

A: 네, 가능하면 피하세요. 대신 싱글톤이나 의존성 주입을 사용하세요.

Q6: Linkage 학습 리소스는?

“The C++ Programming Language” (Bjarne Stroustrup)
cppreference.com
컴파일러 문서

같이 보면 좋은 글 (내부 링크)

이 주제와 연결되는 다른 글입니다.

심화 부록: 구현·운영 관점

이 부록은 앞선 본문에서 다룬 주제(「C++ Linkage와 Storage | ‘연결과 저장 기간’ 가이드」)를 구현·런타임·운영 관점에서 다시 압축합니다. 도메인별 세부 구현은 글마다 다르지만, 입력 검증 → 핵심 연산 → 부작용(I/O·네트워크·동시성) → 관측의 흐름으로 장애를 나누면 원인 추적이 빨라집니다.

내부 동작과 핵심 메커니즘

flowchart TD
  A[입력·요청·이벤트] --> B[파싱·검증·디코딩]
  B --> C[핵심 연산·상태 전이]
  C --> D[부작용: I/O·네트워크·동시성]
  D --> E[결과·관측·저장]

sequenceDiagram
  participant C as 클라이언트/호출자
  participant B as 경계(런타임·게이트웨이·프로세스)
  participant D as 의존성(API·DB·큐·파일)
  C->>B: 요청/이벤트
  B->>D: 조회·쓰기·RPC
  D-->>B: 지연·부분 실패·재시도 가능
  B-->>C: 응답 또는 오류(코드·상관 ID)

불변 조건(Invariant): 버퍼 경계, 프로토콜 상태, 트랜잭션 격리, FD 상한 등 단계별로 문장으로 적어 두면 디버깅 비용이 줄어듭니다.
결정성: 순수 층과 시간·네트워크·스케줄에 의존하는 층을 분리해야 테스트와 장애 분석이 쉬워집니다.
경계 비용: 직렬화, 인코딩, syscall 횟수, 락 경합, 할당·GC, 캐시 미스를 의심 목록에 둡니다.
백프레셔: 생산자가 소비자보다 빠를 때 버퍼·큐·스트림에서 속도를 줄이는 신호를 어디에 둘지 정의합니다.

프로덕션 운영 패턴

영역	운영 관점 질문
관측성	요청 단위 상관 ID, 에러율·지연 p95/p99, 의존성 타임아웃·재시도가 대시보드에 보이는가
안전성	입력 검증·권한·비밀·감사 로그가 코드 경로마다 일관적인가
신뢰성	재시도는 멱등 연산에만 적용되는가, 서킷 브레이커·백오프·DLQ가 있는가
성능	캐시·배치 크기·커넥션 풀·인덱스·백프레셔가 데이터 규모에 맞는가
배포	롤백 룬북, 카나리/블루그린, 마이그레이션·피처 플래그가 문서화되어 있는가
용량	피크 트래픽·디스크·FD·스레드 풀 상한을 주기적으로 검증하는가

스테이징은 데이터 양·네트워크 RTT·동시성을 프로덕션에 가깝게 맞출수록 재현율이 올라갑니다.

확장 예시: 엔드투엔드 미니 시나리오

앞선 본문 주제(「C++ Linkage와 Storage | ‘연결과 저장 기간’ 가이드」)를 배포·운영 흐름에 맞춰 옮긴 체크리스트입니다. 도메인에 맞게 단계 이름만 바꿔 적용할 수 있습니다.

입력 계약 고정: 스키마·버전·최대 페이로드·타임아웃·에러 코드를 경계에 둔다.
핵심 경로 계측: 요청 ID, 단계별 지연, 외부 호출 결과 코드를 로그·메트릭·트레이스에서 한 흐름으로 본다.
실패 주입: 의존성 타임아웃·5xx·부분 데이터·락 대기를 스테이징에서 재현한다.
호환·롤백: 설정/마이그레이션/클라이언트 버전을 되돌릴 수 있는지 확인한다.
부하 후 검증: 피크 대비 p95/p99, 에러율, 리소스 상한, 알림 임계값을 점검한다.

handle(request):
  ctx = newCorrelationId()
  validated = validateSchema(request)
  authorize(validated, ctx)
  result = domainCore(validated)
  persistOrEmit(result, idempotentKey)
  recordMetrics(ctx, latency, outcome)
  return result

문제 해결(Troubleshooting)

증상	가능 원인	조치
간헐적 실패	레이스, 타임아웃, 외부 의존성, DNS	최소 재현 스크립트, 분산 트레이스·로그 상관관계, 재시도·서킷 설정 점검
성능 저하	N+1, 동기 I/O, 락 경합, 과도한 직렬화, 캐시 미스	프로파일러·APM으로 핫스팟 확인 후 한 가지씩 제거
메모리 증가	캐시 무제한, 구독/리스너 누수, 대용량 버퍼, 커넥션 미반납	상한·TTL·힙/FD 스냅샷 비교
빌드·배포만 실패	환경 변수, 권한, 플랫폼 차이, lockfile	CI 로그와 로컬 diff, 런타임·이미지 버전 핀
설정 불일치	프로필·시크릿·기본값, 리전	스키마 검증된 설정 단일 소스와 배포 매트릭스 표준화
데이터 불일치	비멱등 재시도, 부분 쓰기, 캐시 무효화 누락	멱등 키·아웃박스·트랜잭션 경계 재검토

권장 순서: (1) 최소 재현 (2) 최근 변경 범위 축소 (3) 환경·의존성 차이 (4) 관측으로 가설 검증 (5) 수정 후 회귀·부하 테스트.

배포 전에는 git add → git commit → git push 후 npm run deploy 순서를 권장합니다.

이 글에서 다루는 키워드 (관련 검색어)

C++, linkage, storage, extern, static 등으로 검색하시면 이 글이 도움이 됩니다.

이 글이 도움이 되셨나요?

여러분의 피드백은 더 나은 콘텐츠를 만드는 데 도움이 됩니다

문제가 있거나 개선 제안이 있으시면 연락처로 알려주세요.

Keyboard Shortcuts

이 글의 핵심

Linkage 종류

External Linkage

Internal Linkage

No Linkage

Storage Duration

Automatic Storage

Static Storage

Thread Storage

Dynamic Storage

실전 예시

예시 1: 싱글톤 (static)

예시 2: 함수 호출 카운터

예시 3: 스레드별 캐시

예시 4: 익명 네임스페이스

extern 사용법

변수 선언

const와 extern

템플릿 extern

static 키워드

함수 내 static

클래스 static 멤버

자주 발생하는 문제

문제 1: static 초기화 순서

문제 2: extern 중복 정의

문제 3: thread_local 초기화

초기화 순서

정적 초기화

동적 초기화

함수 내 static

FAQ

Q1: extern과 static의 차이는?

Q2: thread_local은 언제 사용하나요?

Q3: static 초기화 순서 문제는?

Q4: extern “C”는 왜 필요한가요?

Q5: 전역 변수는 피해야 하나요?

Q6: Linkage 학습 리소스는?

같이 보면 좋은 글 (내부 링크)

관련 글

심화 부록: 구현·운영 관점

내부 동작과 핵심 메커니즘

프로덕션 운영 패턴

확장 예시: 엔드투엔드 미니 시나리오

문제 해결(Troubleshooting)

이 글에서 다루는 키워드 (관련 검색어)

이 글이 도움이 되셨나요?