跳到主要内容

CMake 环境配置

本章将介绍如何在不同操作系统上安装和配置 CMake 开发环境。

安装 CMake​

Windows​

方法一：官方安装包​

  1. 访问 CMake 下载页面
  2. 下载 Windows 安装包（如 cmake-3.28.0-windows-x86_64.msi）
  3. 运行安装程序，选择 "Add CMake to the system PATH"

方法二：使用包管理器​

# 使用 Chocolatey
choco install cmake

# 使用 Scoop
scoop install cmake

# 使用 Winget
winget install Kitware.CMake

Linux​

Ubuntu/Debian​

# 使用 apt（可能不是最新版本）
sudo apt update
sudo apt install cmake

# 安装最新版本（推荐）
# 添加 Kitware 仓库
wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor - | sudo tee /usr/share/keyrings/kitware-archive-keyrings.gpg >/dev/null
echo 'deb [signed-by=/usr/share/keyrings/kitware-archive-keyrings.gpg] https://apt.kitware.com/ubuntu/ jammy main' | sudo tee /etc/apt/sources.list.d/kitware.list >/dev/null
sudo apt update
sudo apt install cmake

CentOS/RHEL/Fedora​

# Fedora
sudo dnf install cmake

# CentOS/RHEL
sudo yum install cmake

macOS​

# 使用 Homebrew
brew install cmake

# 使用 MacPorts
sudo port install cmake

验证安装​

# 检查版本
cmake --version

# 输出示例
cmake version 3.28.0
CMake suite maintained and supported by Kitware (kitware.com/cmake).

CMake GUI 工具​

cmake-gui​

CMake 提供了图形界面工具，适合初学者使用：

# Linux
cmake-gui

# Windows
# 从开始菜单启动 CMake (cmake-gui)

ccmake（命令行界面）​

# 在构建目录中运行
cd build
ccmake ..

构建工具配置​

CMake 需要本地构建工具来执行实际的编译。以下是常见选择：

Windows​

工具说明
Visual Studio微软官方 IDE，支持 MSVC 编译器
MinGWWindows 版 GCC
Ninja快速的构建工具
# 使用 Visual Studio 生成器
cmake -G "Visual Studio 17 2022" ..

# 使用 Ninja 生成器
cmake -G "Ninja" ..

Linux​

工具安装命令
GCCsudo apt install build-essential
Clangsudo apt install clang
Ninjasudo apt install ninja-build
Makesudo apt install make

macOS​

# 安装 Xcode 命令行工具
xcode-select --install

# 使用 Homebrew 安装其他工具
brew install ninja

第一个 CMake 项目​

创建一个简单的 CMake 项目来验证环境配置：

项目结构​

hello_cmake/
├── CMakeLists.txt
└── main.cpp

创建文件​

main.cpp：

#include <iostream>

int main() {
    std::cout << "Hello, CMake!" << std::endl;
    return 0;
}

CMakeLists.txt：

cmake_minimum_required(VERSION 3.15)
project(HelloCMake)

add_executable(hello main.cpp)

构建项目​

# 创建构建目录
mkdir build
cd build

# 配置项目
cmake ..

# 构建项目
cmake --build .

# 运行程序
./hello  # Linux/macOS
hello.exe  # Windows

单行构建​

cmake -B build && cmake --build build

IDE 集成​

VS Code​

安装 CMake Tools 扩展：

  1. 打开 VS Code
  2. 按 Ctrl+Shift+X 打开扩展面板
  3. 搜索 "CMake Tools"
  4. 点击安装

配置设置 (settings.json)：

{
    "cmake.configureOnOpen": true,
    "cmake.buildDirectory": "${workspaceFolder}/build",
    "cmake.generator": "Ninja"
}

CLion​

CLion 原生支持 CMake，无需额外配置。

Visual Studio​

Visual Studio 2017 及以上版本原生支持 CMake：

  1. 打开 文件 > 打开 > CMake
  2. 选择 CMakeLists.txt 文件

常见问题​

找不到编译器​

# 指定编译器
cmake -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++ ..

# 或在 CMakeLists.txt 中设置
set(CMAKE_C_COMPILER gcc)
set(CMAKE_CXX_COMPILER g++)

编码问题（Windows）​

# 在 CMakeLists.txt 开头添加
if(WIN32)
    add_compile_options(/utf-8)
endif()

路径问题​

# 使用正斜杠（推荐）
set(SOURCES src/main.cpp src/utils.cpp)

# 或使用 ${CMAKE_CURRENT_SOURCE_DIR}
set(SOURCES 
    ${CMAKE_CURRENT_SOURCE_DIR}/src/main.cpp
    ${CMAKE_CURRENT_SOURCE_DIR}/src/utils.cpp
)

小结​

本章我们学习了：

  1. 在不同操作系统上安装 CMake
  2. 配置本地构建工具
  3. 使用 cmake-gui 和 ccmake 工具
  4. 创建和构建第一个 CMake 项目
  5. IDE 集成配置

练习​

  1. 安装 CMake 并验证版本
  2. 创建一个简单的 "Hello World" 项目
  3. 分别使用 Make 和 Ninja 生成器构建项目
  4. 在 VS Code 中配置 CMake 开发环境