CLion vcpkg 연동 가이드: C++ 외부 라이브러리 설치부터 CMake 설정까지 완벽 정리

C++ 개발을 시작할 때 사실 이 부분이 가장 번거로우시죠? 코드 한 줄 짜는 것보다 라이브러리 하나 불러오다가 하루가 다 가는 경우가 허다합니다. 특히 윈도우 환경은 패키지 관리가 까다롭기로 유명해서 막상 검색해봐도 용어가 너무 어렵고 복잡하게만 느껴지실 거예요. 하지만 2026년 현재, CLion과 vcpkg의 조합은 이런 고충을 획기적으로 해결해주는 비용 절감형 효율적 도구로 자리 잡았습니다. 세팅만 잘해두면 개발 생산성 측면에서 엄청난 혜택을 누릴 수 있죠.

vcpkg 설치 및 준비 사항

vcpkg는 마이크로소프트에서 만든 C++용 패키지 매니저입니다. 마치 스마트폰의 앱스토어처럼, 명령어 하나로 복잡한 라이브러리를 내 컴퓨터에 뚝딱 설치해주죠. 설치 전 반드시 Git과 C++ 컴파일러(Visual Studio 등)가 준비되어 있어야 합니다. 왜냐하면 vcpkg는 라이브러리 소스를 가져와 내 컴퓨터 환경에 맞춰 직접 빌드하는 방식을 쓰기 때문이에요.

• 설치 경로: 가급적 C:\vcpkg처럼 한글과 공백이 없는 경로를 사용하세요.
• 실행 방법: 터미널에서 아래 명령어를 순서대로 입력합니다.

git clone https://github.com/microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.bat

개인적으로 이 부트스트랩 과정이 가장 핵심이라고 생각합니다. 여기서 vcpkg.exe가 생성되어야 비로소 모든 마법이 시작되거든요. 설치 경로는 나중에 CLion 설정에 써야 하니 꼭 따로 메모해두세요.

CLion 프로젝트와 vcpkg 연결

이제 우리가 사용하는 똑똑한 메모장인 CLion에게 vcpkg의 존재를 알려줄 차례입니다. 최신 버전의 CLion은 전용 UI를 지원하지만, 여전히 많은 분이 헷갈려하시는 최적의 조건을 표로 정리해 보았습니다.

구분	설정 위치	입력 내용/방법
UI 통합 방식	Settings > Build > Vcpkg	[+] 버튼 클릭 후 vcpkg 설치 경로 지정
CMake 수동 방식	Settings > Build > CMake	CMake options에 툴체인 경로 입력
패키지 관리	하단 Vcpkg 탭	필요한 라이브러리 검색 및 [Install] 클릭

 
표를 보면 아시겠지만, 사실 UI 통합 방식을 쓰더라도 CMake options에 툴체인 파일을 명시해주는 것이 가장 확실하고 안전한 방법입니다. 아래의 문구를 복사해서 본인의 경로에 맞게 CMake options 칸에 넣어주세요.

-DCMAKE_TOOLCHAIN_FILE=D:/Workspace/vcpkg/scripts/buildsystems/vcpkg.cmake

 
이건 모르면 손해 보는 꿀팁인데, 윈도우 경로를 복사하면 역슬래시(\)로 표시되지만 CMake 설정에서는 슬래시(/)로 바꿔서 입력해야 오류가 안 납니다. 저도 처음엔 이 사소한 것 때문에 몇 시간을 헤맸던 기억이 나네요.

vcpkg.json 매니페스트 모드로 프로젝트 관리하기

라이브러리를 매번 전역으로 설치하는 '클래식 모드'는 나중에 프로젝트가 많아지면 버전이 꼬이기 쉽습니다. 그래서 요즘은 프로젝트 폴더 안에 vcpkg.json이라는 명세서를 두는 '매니페스트 모드'를 주로 사용해요. 이건 마치 대형마트 오픈런을 준비할 때 미리 장바구니 리스트를 적어두는 것과 같습니다. 리스트만 있으면 vcpkg가 알아서 필요한 물건을 다 담아오거든요.

{
    "name": "my-project",
    "version": "1.0.0",
    "dependencies": [
        "fmt",
        "jsoncpp"
    ]
}

 
이렇게 파일을 만들면 CLion이 자동으로 감지해서 라이브러리를 설치할지 물어봅니다. 이 방식이 좋은 이유는 나중에 친구에게 프로젝트를 넘겨줄 때, 친구도 이 파일 하나만 있으면 똑같은 라이브러리 환경을 구축할 수 있기 때문이죠.

모든 상황에서 만능은 아닙니다

하지만 이렇게 편한 vcpkg도 조심해야 할 점이 있습니다. 솔직히 말씀드리면, 모든 사용자에게 이 방식이 최선은 아닐 수 있거든요.

일단, 라이브러리를 설치할 때 내 컴퓨터에서 직접 컴파일을 하기 때문에 사양이 낮은 노트북에서는 시간이 상당히 오래 걸릴 수 있습니다. 특히 Boost 같은 대형 라이브러리는 커피 한 잔 마시고 와도 부족할 때가 있죠. 또한, 윈도우용으로 설치한 라이브러리를 리눅스(WSL) 환경에서 그대로 쓰려고 하면 절대 안 됩니다. 각 환경에 맞는 'Triplet(빌드 대상)'을 정확히 설정해주어야 하는데, 초보자분들이 여기서 가장 많은 좌절을 겪곤 합니다.

실시간 가격이나 혜택을 비교하듯 본인의 컴퓨터 사양과 프로젝트 규모에 맞는 라이브러리만 골라 담는 것이 시스템 자원을 아끼는 길입니다.

실제 코드에서 라이브러리 사용하기

설치가 끝났다면 CMakeLists.txt에 해당 라이브러리를 링크해줘야 합니다. vcpkg의 툴체인 파일 덕분에 아주 간단해졌어요.

find_package(fmt REQUIRED)
add_executable(myapp main.cpp)
target_link_libraries(myapp PRIVATE fmt::fmt)

 
이후 main.cpp에서 #include <fmt/core.h>를 입력했을 때 빨간 줄이 뜨지 않는다면 성공입니다! 이 과정은 마치 복잡한 퍼즐의 조각을 딱 맞는 자리에 끼워 넣는 것만큼이나 쾌감을 주는 작업이죠.
 
결국 핵심은 도구가 아니라 우리가 만들 결과물이겠죠? 하지만 그 결과물까지 가는 길이 너무 험난하면 시작도 전에 지치기 마련입니다. CLion과 vcpkg는 그 험난한 길을 닦아주는 아주 고마운 존재예요. 제 생각에는 지금 바로 간단한 'Hello World' 프로젝트를 만들어서 평소 써보고 싶었던 외부 라이브러리 하나를 연동해보는 게 가장 빠르게 익히는 방법인 것 같아요.
 
혹시 여기까지 따라오시면서 막히는 부분이 있었나요? 아니면 본인만의 더 편한 세팅 방법이 있으신가요? 여러분의 경험을 공유해주시면 다른 분들에게도 큰 도움이 될 것 같습니다. 지금 소개한 기본적인 연동 외에도 특정 버전의 라이브러리를 고정해서 사용하는 'Versioning' 기능이나 커스텀 라이브러리를 등록하는 법 등 더 강력한 대안들도 존재하니, 익숙해지면 하나씩 도전해보시길 추천합니다.
 
더 상세한 문제 해결 방법이나 최신 릴리스 정보는 반드시 vcpkg 공식 깃허브나 JetBrains 기술 블로그를 통해 한 번 더 체크해보시는 것도 잊지 마세요!

PyCharm과 Docker Compose로 끝내는 파이썬 멀티 컨테이너 개발 환경 완벽 가이드