[2026] C++ CMake Quick Start | Minimal CMakeLists, Libraries & Subprojects

Default CMakeLists.txt

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

cmake_minimum_required(VERSION 3.10)
project(MyProject)
set(CMAKE_CXX_STANDARD 17)
add_executable(myapp main.cpp)

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

mkdir build
cd build
cmake ..
make
./myapp

Multiple source files

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

cmake_minimum_required(VERSION 3.10)
project(MyProject)
set(CMAKE_CXX_STANDARD 17)
add_executable(myapp 
    main.cpp
    utils.cpp
    math.cpp
)

Creating a library

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

# static library
add_library(mylib STATIC
    lib.cpp
    helper.cpp
)
# Dynamic library
add_library(mylib SHARED
    lib.cpp
    helper.cpp
)
# Link to executable file
add_executable(myapp main.cpp)
target_link_libraries(myapp mylib)

Header file path

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

# Project structure
# project/
#   CMakeLists.txt
#   src/
#     main.cpp
#   include/
#     mylib.h
cmake_minimum_required(VERSION 3.10)
project(MyProject)
include_directories(${PROJECT_SOURCE_DIR}/include)
add_executable(myapp src/main.cpp)

Practical example

Example 1: Basic project structure

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

MyProject/
├── CMakeLists.txt
├── src/
│   ├── main.cpp
│   ├── math.cpp
│   └── utils.cpp
├── include/
│   ├── math.h
│   └── utils.h
└── build/

CMakeLists.txt: 다음은 cmake를 활용한 상세한 구현 코드입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

cmake_minimum_required(VERSION 3.10)
project(MyProject VERSION 1.0)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED True)
# Header file path
include_directories(${PROJECT_SOURCE_DIR}/include)
# Source file list
set(SOURCES
    src/main.cpp
    src/math.cpp
    src/utils.cpp
)
# Create executable file
add_executable(myapp ${SOURCES})
# Compilation options
target_compile_options(myapp PRIVATE
    -Wall
    -Wextra
    -O2
)

Build: 다음은 간단한 bash 코드 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

mkdir build && cd build
cmake ..
make
./myapp

Example 2: Using an external library

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

cmake_minimum_required(VERSION 3.10)
project(MyProject)
set(CMAKE_CXX_STANDARD 17)
# find pthread
find_package(Threads REQUIRED)
add_executable(myapp main.cpp)
# pthread link
target_link_libraries(myapp Threads::Threads)

Example 3: Subdirectory structure

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

MyProject/
├── CMakeLists.txt
├── app/
│   ├── CMakeLists.txt
│   └── main.cpp
└── lib/
    ├── CMakeLists.txt
    ├── mylib.cpp
    └── mylib.h

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

// 실행 예제
cmake_minimum_required(VERSION 3.10)
project(MyProject)
set(CMAKE_CXX_STANDARD 17)
add_subdirectory(lib)
add_subdirectory(app)

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

// 실행 예제
add_library(mylib STATIC
    mylib.cpp
)
target_include_directories(mylib PUBLIC
    ${CMAKE_CURRENT_SOURCE_DIR}
)

app/CMakeLists.txt:

add_executable(myapp main.cpp)
target_link_libraries(myapp mylib)

Advanced features

Conditional compilation

아래 코드는 cmake를 사용한 구현 예제입니다. 조건문으로 분기 처리를 수행합니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

option(BUILD_TESTS "Build tests" ON)
if(BUILD_TESTS)
    add_subdirectory(tests)
endif()
# use
cmake -DBUILD_TESTS=OFF ..

Platform-specific settings

아래 코드는 cmake를 사용한 구현 예제입니다. 조건문으로 분기 처리를 수행합니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

if(WIN32)
    # Windows
    add_definitions(-DWINDOWS)
elseif(APPLE)
    # macOS
    add_definitions(-DMACOS)
elseif(UNIX)
    # Linux
    add_definitions(-DLINUX)
endif()

Build type

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

# Debug, Release, RelWithDebInfo, MinSizeRel
set(CMAKE_BUILD_TYPE Release)
# use
cmake -DCMAKE_BUILD_TYPE=Debug ..

Installation Rules

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

# Install executable file
install(TARGETS myapp
    DESTINATION bin
)
# Install header files
install(FILES mylib.h
    DESTINATION include
)
# Install library
install(TARGETS mylib
    DESTINATION lib
)
# use
make install

Frequently occurring problems

Issue 1: Header file not found

Symptom: fatal error: mylib.h: No such file or directory Cause: Include path not set dissolvent: 아래 코드는 cmake를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

# ❌ No path
add_executable(myapp main.cpp)
# ✅ Add path
include_directories(${PROJECT_SOURCE_DIR}/include)
add_executable(myapp main.cpp)
# ✅ Add by target (more recommended)
target_include_directories(myapp PRIVATE
    ${PROJECT_SOURCE_DIR}/include
)

Problem 2: Library link error

Symptom: undefined reference to function Cause: Missing library link dissolvent: 아래 코드는 cmake를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

# ❌ Link not available
add_executable(myapp main.cpp)
# ✅ Library Links
add_executable(myapp main.cpp)
target_link_libraries(myapp mylib)

Issue 3: CMake cache issues

Symptom: Setting changes are not reflected Cause: Cached settings dissolvent: 아래 코드는 bash를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

# Delete build directory
rm -rf build
mkdir build && cd build
cmake ..
# Or just delete the cache
rm CMakeCache.txt
cmake ..

Useful commands

Variable output

message(STATUS "CMAKE_CXX_COMPILER: ${CMAKE_CXX_COMPILER}")
message(STATUS "PROJECT_SOURCE_DIR: ${PROJECT_SOURCE_DIR}")

Automatically generate file list

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

file(GLOB SOURCES "src/*.cpp")
add_executable(myapp ${SOURCES})
# recursively
file(GLOB_RECURSE SOURCES "src/*.cpp")

Compiler check

아래 코드는 cmake를 사용한 구현 예제입니다. 조건문으로 분기 처리를 수행합니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

if(CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
    target_compile_options(myapp PRIVATE -Wall -Wextra)
elseif(MSVC)
    target_compile_options(myapp PRIVATE /W4)
endif()

FAQ

Q1: CMake vs Makefile?

A:

• CMake: cross-platform, automatic generation
• Makefile: platform dependent, manually written

Q2: What is an out-of-source build?

A: Separate source and build directories. Recommended. 아래 코드는 bash를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

# out-of-source (recommended)
mkdir build && cd build
cmake ..
# in-source (not recommended)
cmake .

Q3: Which version of CMake should I use?

A: Use at least 3.10 or the latest version if possible.

Q4: How does find_package work?

A: CMake will find the library on your system.

find_package(OpenCV REQUIRED)
target_link_libraries(myapp ${OpenCV_LIBS})

Q5: Multiple build types at the same time?

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

mkdir build-debug && cd build-debug
cmake -DCMAKE_BUILD_TYPE=Debug ..
mkdir build-release && cd build-release
cmake -DCMAKE_BUILD_TYPE=Release ..

Q6: What are CMake learning resources?

A:

• Official document: cmake.org
• Modern CMake: cliutils.gitlab.io/modern-cmake
• Example: github.com/ttroy50/cmake-examples

---

Good article to read together (internal link)

Here’s another article related to this topic.

• C++ CMake Advanced | Multi-target/external library management (large-scale project build)
• C++ Compilation Process | “Compilation Process” Guide
• C++ Makefile | “Make Build” Guide

Practical tips

These are tips that can be applied right away in practice.

Debugging tips

• If you run into a problem, check the compiler warnings first.
• Reproduce the problem with a simple test case

Performance Tips

• Don’t optimize without profiling
• Set measurable indicators first

Code review tips

• Check in advance for areas that are frequently pointed out in code reviews.
• Follow your team’s coding conventions

---

Practical checklist

This is what you need to check when applying this concept in practice.

Before writing code

• Is this technique the best way to solve the current problem?
• Can team members understand and maintain this code?
• Does it meet the performance requirements?

Writing code

• Have you resolved all compiler warnings?
• Have you considered edge cases?
• Is error handling appropriate?

When reviewing code

• Is the intent of the code clear?
• Are there enough test cases?
• Is it documented? Use this checklist to reduce mistakes and improve code quality.

---

Keywords covered in this article (related search terms)

This article will be helpful if you search for C++, CMake, Build System, Build, Compile, etc.

Related articles

• C++ CMake find_package complete guide | External library integration
• C++ CMake Targets Complete Guide | Target-based build system
• CMake error |
• C++ CMake Advanced | Multi-target/external library management (large-scale project build)
• C++ vcpkg advanced usage | Manifest·Triplet·Overlay·Binary Cache Guide