CMake 安装与配置

CMake 安装与配置详解（2025 最新版）

CMake 是跨平台 C/C++ 项目构建工具，本节重点讲解在 Windows、macOS、Linux 三大平台上的安装方法以及常用配置（环境变量、IDE 集成、缓存配置等）。

1. 安装 CMake

Windows

推荐方式（最简单）：

1. 访问官网：https://cmake.org/download/
2. 下载最新版 Windows x64 Installer（例如 cmake-3.30.5-windows-x86_64.msi）
3. 双击运行安装程序，关键步骤：

• 勾选 “Add CMake to the system PATH for all users”（推荐）
  或 “Add CMake to the system PATH for current user”
• 这会自动将 cmake.exe 所在目录加入环境变量 PATH

验证安装：
打开 命令提示符 或 PowerShell，输入：

cmake --version

显示版本号即成功。

macOS

推荐使用 Homebrew（包管理器）：

1. 如果没有 Homebrew，先安装：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 CMake：

   brew install cmake

验证：

cmake --version

Linux

Ubuntu / Debian 系：

sudo apt update
sudo apt install cmake

CentOS / Rocky Linux / Fedora：

# CentOS/Rocky
sudo dnf install cmake

# Fedora
sudo dnf install cmake

Arch Linux：

sudo pacman -S cmake

验证同上：cmake --version

2. 手动添加环境变量（如果安装时未自动添加）

Windows

1. 右键“此电脑” → 属性 → 高级系统设置 → 环境变量
2. 在“系统变量”中找到 Path，点击编辑 → 新建
3. 添加 CMake 的 bin 目录，例如：

   C:\Program Files\CMake\bin

4. 确定后重新打开终端即可使用 cmake

Linux / macOS

编辑 ~/.bashrc 或 ~/.zshrc（根据你用的 shell）：

export PATH="/usr/local/bin:$PATH"  # macOS Homebrew 通常在这里
# 或 Ubuntu 默认在 /usr/bin/cmake，已在 PATH 中

然后执行：

source ~/.bashrc  # 或 ~/.zshrc

3. IDE 集成配置

Visual Studio (Windows)

• 安装 CMake 后，VS 2022+ 已内置 CMake 支持（无需额外插件）
• 新建项目 → “CMake 项目” 或打开现有 CMakeLists.txt
• VS 会自动调用 cmake 生成缓存并提供 IntelliSense

Visual Studio Code

1. 安装扩展：

• CMake Tools（Microsoft 官方）
• CMake Language Support
• C/C++（Microsoft）

1. 打开项目文件夹后，VS Code 会提示配置 CMake
2. 推荐在 settings.json 中添加：

{
    "cmake.cmakePath": "C:/Program Files/CMake/bin/cmake.exe",  // Windows 示例
    "cmake.buildDirectory": "${workspaceFolder}/build"
}

CLion (JetBrains)

• 自带 CMake 支持，开箱即用
• 首次打开项目会自动检测 CMakeLists.txt 并配置

Qt Creator

• 工具 → 选项 → Kits → CMake
• 指定 CMake 可执行文件路径（通常自动检测）

4. 常用配置选项（cmake 命令行）

在项目构建时常用以下参数：

参数	说明	示例
-DCMAKE_BUILD_TYPE=Debug/Release	设置构建类型（Debug 有调试信息）	cmake -DCMAKE_BUILD_TYPE=Debug ..
-G "Ninja"	使用 Ninja 构建系统（比 Make 更快）	cmake -G "Ninja" ..
-DCMAKE_CXX_STANDARD=17	指定 C++ 标准	cmake -DCMAKE_CXX_STANDARD=20 ..
-DCMAKE_INSTALL_PREFIX=/usr/local	指定安装路径	用于 make install
-S . -B build	显式指定源码目录和构建目录（CMake 3.13+）	cmake -S . -B build

推荐构建流程（跨平台统一）：

mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release   # 生成构建系统
cmake --build .                       # 编译
ctest .                               # 运行测试（如果有）
cmake --install . --prefix /usr/local # 安装（可选）

5. CMake 缓存与清理

• 首次运行 cmake .. 会在 build 目录生成 CMakeCache.txt
• 修改 CMakeLists.txt 后，通常重新运行 cmake .. 即可更新
• 彻底清理：删除整个 build 目录重新生成（最保险）

小结

平台	推荐安装方式	是否自动加入 PATH
Windows	官方 MSI 安装器	安装时勾选即可
macOS	brew install cmake	自动
Linux	系统包管理器（apt/dnf/pacman）	自动

安装完成后，运行 cmake --version 确认成功，你就可以开始编写 CMakeLists.txt 管理项目了！

如果你需要针对特定场景的配置（如交叉编译、Android NDK、嵌入式、Conan/vcpkg 包管理集成等），欢迎继续提问！