Cmake

mohitmishra786/low-level-dev-skills/skills/build-systems/cmake

作者 mohitmishra786bdc58472fa9f无许可证253 个星标收录于 2026年10月9日更新于 2026年10月9日仓库3个月前更新

CMake build system skill for C/C++ projects. Use when writing or refactoring CMakeLists.txt, configuring out-of-source builds, selecting generators (Ninja, Make, VS), managing targets and dependencies with target_link_libraries, integrating external packages via find_package or FetchContent, enabling sanitizers, setting up toolchain files for cross-compilation, or exporting CMake packages. Activates on queries about CMakeLists.txt, cmake configure errors, target properties, install rules, CPack, or CMake presets.

仅含说明Software Development
AI 生成的概览

指导代理使用现代目标优先的 CMake 构建 C/C++ 项目，涵盖构建、依赖、消毒器和交叉编译。

功能
该技能提供编写和重构 CMakeLists.txt 的参考说明，采用现代的目标优先 CMake 写法。内容涵盖源外构建、生成器选择、静态库与共享库、通过 find_package、FetchContent 和 pkg-config 管理依赖、消毒器选项、交叉编译工具链文件、CMake Presets 以及常见配置错误。它还指向一份随附的模板参考文档。
适用场景
适用于编写或重构 CMakeLists.txt、配置源外构建、选择 Ninja、Make 或 Visual Studio 等生成器，或管理目标与依赖的场景。也适合启用消毒器、设置交叉编译工具链文件、导出 CMake 包以及排查 CMake 配置错误。
运行要求
不附带脚本，仅为说明性内容。需要已安装 CMake（多数功能需 3.20 或更高版本）和 C/C++ 工具链；仅在使用 FetchContent 获取依赖时需要网络访问。

CMake

Purpose

Guide agents through modern (target-first) CMake for C/C++ projects: out-of-source builds, dependency management, generator selection, and integration with CI and IDEs.

Triggers

  • "How do I write a CMakeLists.txt for my project?"
  • "How do I add an external library with CMake?"
  • "CMake can't find my package / library"
  • "How do I enable sanitizers in CMake?"
  • "How do I cross-compile with CMake?"
  • "How do I use CMake Presets?"

Workflow

1. Modern CMake principles

  • Define targets, not variables. Use target_* commands.
  • Use PUBLIC/PRIVATE/INTERFACE to control property propagation.
  • Never use include_directories() or link_libraries() (legacy).
  • Minimum CMake version: cmake_minimum_required(VERSION 3.20) for most features.

2. Minimal project

cmake
cmake_minimum_required(VERSION 3.20)project(MyApp VERSION 1.0 LANGUAGES C CXX)
set(CMAKE_C_STANDARD 11)set(CMAKE_C_STANDARD_REQUIRED ON)set(CMAKE_CXX_STANDARD 17)set(CMAKE_CXX_STANDARD_REQUIRED ON)
add_executable(myapp    src/main.c    src/utils.c)
target_include_directories(myapp PRIVATE include)target_compile_options(myapp PRIVATE -Wall -Wextra)

3. Static / shared libraries

cmake
# Static libraryadd_library(mylib STATIC lib/foo.c lib/bar.c)target_include_directories(mylib    PUBLIC  include      # consumers get this include path    PRIVATE src          # only mylib itself sees this)
# Shared libraryadd_library(myshared SHARED lib/foo.c)set_target_properties(myshared PROPERTIES    VERSION   1.0.0    SOVERSION 1)
# Link executable against libraryadd_executable(myapp src/main.c)target_link_libraries(myapp PRIVATE mylib)

4. Configure and build

bash
# Out-of-source build (always do this)cmake -S . -B buildcmake --build build
# With generatorcmake -S . -B build -G Ninjacmake --build build -- -j$(nproc)
# Debug buildcmake -S . -B build-debug -DCMAKE_BUILD_TYPE=Debugcmake --build build-debug
# Releasecmake -S . -B build-release -DCMAKE_BUILD_TYPE=Releasecmake --build build-release
# Installcmake --install build --prefix /usr/local

Build types: Debug, Release, RelWithDebInfo, MinSizeRel.

5. External dependencies

find_package (system-installed libraries)
cmake
find_package(OpenSSL REQUIRED)target_link_libraries(myapp PRIVATE OpenSSL::SSL OpenSSL::Crypto)
find_package(Threads REQUIRED)target_link_libraries(myapp PRIVATE Threads::Threads)
find_package(ZLIB REQUIRED)target_link_libraries(myapp PRIVATE ZLIB::ZLIB)
FetchContent (download and build dependency)
cmake
include(FetchContent)
FetchContent_Declare(    googletest    GIT_REPOSITORY https://github.com/google/googletest.git    GIT_TAG        v1.14.0)FetchContent_MakeAvailable(googletest)
add_executable(mytest test/test_foo.cpp)target_link_libraries(mytest PRIVATE GTest::gtest_main mylib)
pkg-config fallback
cmake
find_package(PkgConfig REQUIRED)pkg_check_modules(LIBFOO REQUIRED libfoo>=1.2)target_link_libraries(myapp PRIVATE ${LIBFOO_LIBRARIES})target_include_directories(myapp PRIVATE ${LIBFOO_INCLUDE_DIRS})

6. Compiler options by configuration

cmake
target_compile_options(myapp PRIVATE    $<$<CONFIG:Debug>:-g -Og -fsanitize=address>    $<$<CONFIG:Release>:-O2 -DNDEBUG>    $<$<CXX_COMPILER_ID:GNU>:-fanalyzer>    $<$<CXX_COMPILER_ID:Clang>:-Weverything>)
target_link_options(myapp PRIVATE    $<$<CONFIG:Debug>:-fsanitize=address>)

Generator expressions: $<condition:value> evaluated at build time.

7. Enable sanitizers

cmake
option(ENABLE_ASAN "Enable AddressSanitizer" OFF)
if(ENABLE_ASAN)    target_compile_options(myapp PRIVATE -fsanitize=address -fno-omit-frame-pointer -g -O1)    target_link_options(myapp PRIVATE -fsanitize=address)endif()

Build: cmake -DENABLE_ASAN=ON -S . -B build-asan && cmake --build build-asan

8. Cross-compilation toolchain file

cmake
# toolchain-aarch64.cmakeset(CMAKE_SYSTEM_NAME Linux)set(CMAKE_SYSTEM_PROCESSOR aarch64)set(CMAKE_C_COMPILER   aarch64-linux-gnu-gcc)set(CMAKE_CXX_COMPILER aarch64-linux-gnu-g++)set(CMAKE_SYSROOT /opt/aarch64-sysroot)set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
bash
cmake -S . -B build-arm -DCMAKE_TOOLCHAIN_FILE=toolchain-aarch64.cmake

9. CMake Presets (CMake 3.20+)

json
{  "version": 6,  "configurePresets": [    {      "name": "release",      "displayName": "Release",      "generator": "Ninja",      "binaryDir": "${sourceDir}/build/release",      "cacheVariables": {        "CMAKE_BUILD_TYPE": "Release",        "CMAKE_EXPORT_COMPILE_COMMANDS": "ON"      }    },    {      "name": "debug",      "displayName": "Debug",      "generator": "Ninja",      "binaryDir": "${sourceDir}/build/debug",      "cacheVariables": {        "CMAKE_BUILD_TYPE": "Debug",        "ENABLE_ASAN": "ON"      }    }  ],  "buildPresets": [    { "name": "release", "configurePreset": "release" },    { "name": "debug",   "configurePreset": "debug" }  ]}
bash
cmake --preset releasecmake --build --preset release

10. Common errors

ErrorCauseFix
Could not find package FooPackage not installed or wrong prefixInstall dev package; set CMAKE_PREFIX_PATH
No CMAKE_CXX_COMPILERNo C++ compiler foundInstall g++/clang++; check PATH
target_link_libraries called with wrong number of argumentsMissing PUBLIC/PRIVATE/INTERFACEAdd the keyword
Cannot find source fileTypo or wrong relative pathCheck path relative to CMakeLists.txt
generator expression errorWrong $<> syntaxCheck CMake docs for expression name

For a complete CMakeLists.txt template, see references/templates.md [blocked].

Related skills

  • Use skills/build-systems/ninja for Ninja generator details
  • Use skills/build-systems/make for Make generator
  • Use skills/compilers/cross-gcc for cross-compilation toolchain setup
  • Use skills/runtimes/sanitizers for sanitizer integration details

来源与署名

来源：mohitmishra786/low-level-dev-skills位于skills/build-systems/cmake提交bdc5847

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 mohitmishra786/low-level-dev-skills 的技能

Zig Debugging

mohitmishra786

指导使用 GDB、LLDB 调试 Zig 程序，解读 panic、错误返回追踪、日志记录及 IDE 配置。

Software Development2533个月前更新

Simd Intrinsics

mohitmishra786

指导使用 x86 SSE/AVX 与 ARM NEON 内建函数编写和诊断 SIMD 向量化。

Software Development2533个月前更新

Zig Cross

mohitmishra786

指导 Zig 交叉编译：目标三元组、CPU 特性、用 zig cc 编译 C、嵌入式与 WASM 目标。

Software Development2533个月前更新

Rustc Basics

mohitmishra786

指导 Rust 编译器配置：RUSTFLAGS、Cargo 配置文件、构建调优，以及查看 MIR 或汇编输出。

Software Development2533个月前更新

Zig Cinterop

mohitmishra786

指导 Zig 与 C 互操作：@cImport、translate-c、extern 与 packed 结构体，以及 C/Zig 混合构建。

Software Development2533个月前更新

Zig Build System

mohitmishra786

指导编写和调试 Zig 的 build.zig 文件，涵盖目标、C 源码、选项、测试与包清单。

Software Development2533个月前更新

更多Software Development技能

Playground

anthropics

精选

构建自包含的交互式 HTML 演练场，包含控件、实时预览和可复制的提示词输出。

Software Development37K今天更新

M5 Onboard

anthropics

精选

通过 USB 检测 M5Stack ESP32 开发板，刷写 UIFlow 2.0 固件并安装 MicroPython 应用包。

Software Development37K今天更新

Cardputer Buddy

anthropics

精选

指导迭代 Cardputer-Adv 的 MicroPython 应用包：添加应用、通过 USB 串口推送文件、查看日志并运行 REPL 命令。

Software Development37K今天更新

Web Design Guidelines

vercel-labs

精选

依据从远程来源获取的 Web Interface Guidelines 审查 UI 代码，并以 file:line 形式报告问题。

Software Development32K5周前更新

Vercel React Native Skills

vercel-labs

精选

React Native 与 Expo 最佳实践规则，涵盖列表性能、动画、导航、UI 模式、状态与 monorepo 配置。

Software Development32K5周前更新

Vercel React Best Practices

vercel-labs

精选

Vercel 的 React 与 Next.js 性能指南，以 70 条规则的形式用于编写、审查和重构代码。

Software Development32K5周前更新