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：

   brewinstallcmake

验证：

cmake --version

Linux

Ubuntu / Debian 系：

sudoaptupdatesudoaptinstallcmake

CentOS / Rocky Linux / Fedora：

# CentOS/Rockysudodnfinstallcmake# Fedorasudodnfinstallcmake

Arch Linux：

sudopacman -S cmake

验证同上：cmake --version

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

Windows

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

   C:\Program Files\CMake\bin

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

Linux / macOS

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

exportPATH="/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）
2. 打开项目文件夹后，VS Code 会提示配置 CMake
3. 推荐在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

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

mkdirbuildcdbuild 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 包管理集成等），欢迎继续提问！