헤더 전용 라이브러리와 컴파일 라이브러리 비교

C++ 라이브러리는 두 가지 형태로 제공됩니다:

• 헤더 전용 — 헤더에 구현이 포함되며, 사용자가 모든 것을 컴파일합니다
• 컴파일된 형태 — 별도의 소스 파일을 정적 또는 공유 라이브러리로 컴파일합니다

장점:

• 복사하고 포함하기만 하면 되므로 통합이 간단함
• 빌드 구성이 필요하지 않음
• 컴파일러와 표준에 관계없이 작동함
• 컴파일러가 적극적으로 인라인화할 수 있음

단점:

• 컴파일 시간이 느림 — 사용하는 쪽마다 모든 것을 다시 빌드함
• ABI가 사용하는 쪽의 컴파일 설정에 따라 결정됨
• 구현이 모든 사용자에게 노출됨
• 여러 번역 단위에서 동일한 템플릿을 사용하면 바이너리 크기가 커짐

널리 사용되는 많은 라이브러리가 헤더 전용입니다:

• nlohmann/json
• spdlog(헤더 전용 모드)
• cxxopts
• Catch2(헤더 전용 변형)

장점:

• 사용하는 쪽의 컴파일 시간이 짧음
• 구현 세부 정보가 숨겨짐
• 템플릿을 한 번만 인스턴스화함
• 바이너리로 제공할 수 있음(소스 공개 불필요)

단점:

• ABI 호환성이 취약함
• 라이브러리와 사용하는 쪽의 빌드 구성이 일치해야 함
• 정적 연결은 바이너리를 비대하게 만들고, 동적 연결에는 런타임 로딩이 필요함

컴파일된 형태는 두 가지입니다:

• 정적(.a, .lib) — 빌드할 때 실행 파일에 연결됨
• 공유(.so, .dll, .dylib) — 런타임에 로드됨

템플릿은 헤더 전용이 아닌 배포 방식을 적용하기 어렵습니다. 일반 코드는 사용하는 쪽마다 인스턴스화되기 때문입니다. 일부 라이브러리는 컴파일된 .a 파일에 "비템플릿" 핵심 기능을 제공하고, 얇은 템플릿을 위한 헤더를 함께 제공합니다.

일부 라이브러리는 두 방식을 모두 지원합니다. 빠른 사용을 위한 단일 헤더 모드와 더 빠른 빌드를 위한 다중 파일 모드를 제공합니다.

헤더 전용 라이브러리가 큰 경우 사전 컴파일된 헤더(PCH)를 사용하면 사용하는 쪽의 빌드 속도를 크게 높일 수 있습니다.

C++20 모듈은 헤더를 대체할 것으로 기대됩니다. 캡슐화가 개선되고, 빌드가 빨라지며, 전처리기에 대한 의존성이 줄어듭니다. 다만 컴파일러와 도구의 지원이 필요하므로 도입은 점진적으로 진행되고 있습니다.

빠른 안내:

• 작은 유틸리티 라이브러리 → 헤더 전용
• 구현 규모가 큰 대형 라이브러리 → 컴파일된 형태
• 템플릿을 많이 사용하는 라이브러리 → 헤더 전용 또는 혼합 방식

사용하는 쪽에서 헤더 전용 라이브러리를 사용할 때 가장 큰 단점은 무엇입니까?

헤더 전용 라이브러리는 통합하기 쉽지만 사용하는 쪽의 빌드가 느려집니다. 컴파일된 라이브러리는 사용하기 빠르지만 배포하기가 더 까다롭습니다. 템플릿은 헤더 전용 방식을 선호하고, 규모가 큰 구현은 컴파일된 방식을 선호합니다. 향후 C++20 모듈이 헤더를 대체할 수도 있습니다.