CMake 跨平台安装指南：Windows、Linux 与 macOS 配置详解

macOS 系统安装

Homebrew 安装

Mac 用户推荐使用 Homebrew 管理：

brew install cmake

官方 DMG 安装

1. 从官网下载 .dmg 文件。
2. 将应用拖入 Applications 文件夹。
3. 配置环境变量：

   echo 'export PATH="/Applications/CMake.app/Contents/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc
   

安装验证

基础命令测试

cmake --help | grep version

检查是否显示当前版本信息。

编译 Hello World

创建一个简单的 CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(HelloWorld)
add_executable(hello main.cpp)

随后执行构建流程：

mkdir build && cd build
cmake ..
make

常见问题处理

Command Not Found

• Windows：检查系统环境变量 PATH 中是否包含 CMake 安装目录。
• Linux/macOS：尝试执行 source ~/.bashrc 或重启终端会话。

版本过低

若需升级版本：

# Ubuntu
sudo apt remove cmake
sudo snap install cmake --classic

# macOS
brew upgrade cmake

权限不足

在执行安装或修改系统文件时，确保拥有管理员权限。部分操作可能需要 sudo 提权。

多版本管理

对于需要同时维护多个项目的场景，建议使用脚本或工具管理多版本 CMake：

# 示例：调用不同版本
cmake3.20 ../
cmake3.28 ../

此外，Docker 容器化编译环境也是解决依赖冲突的有效方案。

最佳实践建议

1. 版本选择：企业级项目通常使用较稳定的 LTS 版本（如 3.5-3.20），盲目追新可能引入不兼容风险。
2. 日志分析：遇到问题时，优先查看 CMakeOutput.log 和 CMakeError.log 定位原因。
3. 缓存清理：遇到奇怪的配置错误，尝试删除 CMakeCache.txt 重新生成。
4. 持续学习：掌握 CMakeLists.txt 编写技巧、多目录项目组织及第三方库集成是进阶关键。