linux安装cmake：全面指南，从安装到初次使用

在Linux环境中进行C/C++项目开发时，构建系统扮演着至关重要的角色。传统上，开发者可能需要手动编写复杂的Makefile来管理编译过程，但随着项目规模的增长和跨平台需求，这种方式变得效率低下且难以维护。这时，CMake应运而生，它作为一个跨平台的开源构建系统生成工具，极大地简化了项目构建的复杂性。本文将深入探讨在Linux系统上安装CMake的方方面面，包括其作用、安装方法、资源需求以及安装后的验证与基本使用。

什么是CMake及其在Linux中的作用？

CMake：不仅仅是Make的替代品

CMake到底是什么？ 简而言之，CMake是一个构建系统生成器。它本身不是一个构建系统（如GNU Make、Ninja），而是一个工具，它读取名为CMakeLists.txt的配置文件，然后根据这些配置生成特定平台和工具链的构建文件（如Unix系统上的Makefile、Windows上的Visual Studio项目文件或Ninja构建文件）。这意味着开发者只需编写一份通用的CMakeLists.txt，就可以在不同的操作系统和IDE上生成对应的构建脚本，从而实现项目的跨平台构建。

为什么在Linux下要使用CMake？

• 跨平台兼容性： 即使只在Linux下开发，但考虑到未来项目可能迁移到其他操作系统，或者需要与使用其他操作系统的团队成员协作，CMake提供了一致的构建方式。
• 简化复杂的构建过程： 随着项目文件增多、依赖关系变复杂，手动编写Makefile会变得异常困难和容易出错。CMake提供了更高级的抽象，通过简单的命令（如add_executable, add_library, target_link_libraries）就能管理这些复杂性。
• 依赖管理： CMake能够方便地查找和链接项目所需的外部库（如Boost、OpenCV、Qt等），并且可以自动处理库的路径和编译选项。
• 模块化与可重用： CMake允许将大型项目分解为多个模块，每个模块有自己的CMakeLists.txt，提高了项目的可维护性和模块的可重用性。
• 标准实践： 现代C/C++项目的开发中，CMake已经成为事实上的标准构建工具之一，掌握它有助于更好地理解和贡献开源项目。

为什么要在Linux上安装CMake？

不安装CMake会有什么影响？ 如果您计划在Linux上开发或编译C/C++项目，特别是那些依赖于CMake进行构建的项目，那么没有CMake将会寸步难行。您将无法生成项目的构建文件，也就无法编译、链接和运行代码。对于许多开源项目而言，其官方的编译指南通常都是以CMake为基础的，缺少它您将无法按照官方推荐的方式来构建项目。

为什么不直接用Make？ 虽然Make是Linux下非常基础且强大的构建工具，但它直接操作的是编译和链接的底层命令，需要开发者详细指定每一个源文件、每一个编译选项、每一个依赖关系。这对于小型项目尚可，但对于包含数百个源文件、几十个库依赖的大型项目来说，手动编写和维护Makefile将是一场噩梦。CMake则通过生成Makefile（或其他构建系统文件）来间接使用Make，它将构建过程中的平台差异、编译器选项、依赖查找等复杂性抽象出来，让开发者关注于项目的结构而不是构建的细节。

从哪里获取CMake以及安装位置？

CMake的获取途径有哪些？

在Linux上获取CMake主要有以下几种途径：

1. 系统包管理器： 这是最常见、最推荐的方式，尤其对于初学者。几乎所有的Linux发行版都提供了CMake的预编译包。
   • Debian/Ubuntu/Linux Mint： APT (Advanced Package Tool)
   • CentOS/RHEL/Fedora： YUM (Yellowdog Updater, Modified) 或 DNF (Dandified YUM)
   • Arch Linux： Pacman
   • openSUSE： Zypper

   这种方式的优点是安装简单、依赖自动解决、易于更新。缺点是包管理器提供的CMake版本可能不是最新的稳定版。

2. 预编译二进制包： CMake官方网站（cmake.org/download/）提供了各种操作系统的预编译二进制文件。您只需下载对应的.tar.gz文件，解压后即可使用。
   这种方式的优点是您可以获取到最新版本的CMake而无需编译。缺点是需要手动管理路径，且不会自动解决系统依赖。
3. 从源码编译安装： 同样从CMake官方网站下载源码包，然后手动进行配置、编译和安装。
   这种方式的优点是您可以完全控制CMake的编译选项，可以针对特定系统进行优化，或者编译一些非标准特性。缺点是过程相对复杂，需要安装编译工具链，耗时较长。

CMake通常安装到哪里？

• 通过包管理器安装： 通常会将可执行文件安装到/usr/bin/，库文件安装到/usr/lib/或/usr/local/lib/，文档安装到/usr/share/doc/等系统标准路径。这些路径通常已经包含在系统的PATH环境变量中，可以直接在任何地方执行cmake命令。
• 从预编译二进制包或源码编译安装：
  • 默认安装路径： 如果不指定安装前缀，通常会安装到/usr/local/目录下（例如，可执行文件在/usr/local/bin/，库文件在/usr/local/lib/）。
  • 自定义安装路径： 在编译或解压后，您可以选择将其放置在任何您有权限的目录中，例如/opt/cmake-x.y.z/或用户自己的~/bin/目录下。在这种情况下，您需要手动将CMake的可执行文件路径添加到系统的PATH环境变量中，以便系统能够找到并执行cmake命令。

安装CMake所需资源与时间？

CMake安装包通常有多大？

• 通过包管理器： 安装包本身通常在几MB到几十MB之间（例如，Debian系的cmake包可能在5-10MB左右）。
• 预编译二进制包： 从官方网站下载的.tar.gz压缩包通常在30MB到50MB之间。
• 源码包： 源码包的压缩大小与二进制包类似，也在30-50MB范围。

安装CMake需要多少磁盘空间？

• 通过包管理器： 完整安装后，占用的磁盘空间通常在50MB到100MB之间，这包括了可执行文件、库文件、文档和一些数据文件。
• 预编译二进制包： 解压后，通常占用50MB到100MB的磁盘空间。
• 从源码编译安装： 编译过程会产生大量的中间文件，可能需要几百MB甚至1GB以上的临时空间。安装完成后，实际占用的空间与二进制包类似，在50-100MB之间。

安装需要多少内存？
无论是通过包管理器安装、解压二进制包还是编译源码，对系统内存的直接需求都非常小，通常在几十MB的范围内。对于源码编译，如果您的系统内存非常有限（例如低于1GB），并且同时运行了其他内存密集型任务，可能会感受到轻微的卡顿，但对于现代Linux系统而言，这通常不是问题。

安装需要多长时间？

• 通过包管理器： 这是最快的安装方式，通常只需要几秒到一分钟，取决于您的网络速度和系统响应速度。
• 预编译二进制包： 下载时间取决于网络速度，解压时间通常在几秒钟内完成。总耗时通常在几分钟之内。
• 从源码编译安装： 这是最耗时的方式。下载源码包通常需要几分钟。编译过程取决于您的CPU性能，可能需要10分钟到1小时不等。如果您的CPU核心数较多，可以使用并行编译来加速（例如make -j$(nproc)）。

如何选择并检查CMake版本？

如何检查Linux系统是否已安装CMake？

在终端中输入以下命令即可：

cmake --version

如果CMake已安装且其路径在您的PATH环境变量中，您将看到类似以下的输出：

cmake version 3.22.1

CMake suite maintained and supported by Kitware (kitware.com/cmake).

如果系统没有找到cmake命令，您可能会看到“command not found”的错误信息，这意味着CMake尚未安装或其路径未正确配置。

如何选择合适的CMake版本？

选择CMake版本通常遵循以下原则：

1. 最新稳定版： 对于新项目或没有特定版本要求的情况，通常建议安装CMake的最新稳定版本。最新版本通常包含新的功能、性能改进和bug修复。
2. 项目特定要求： 某些开源项目或遗留项目可能明确要求使用特定版本的CMake。在这种情况下，您应该遵循项目的要求，以免出现兼容性问题。
3. 包管理器版本： 如果您通过系统包管理器安装，您将获得该发行版仓库中可用的最新版本。对于大多数日常开发，这个版本通常是足够的。如果您需要比包管理器更新的版本，则需要考虑从二进制包或源码安装。
4. LTS（长期支持）版本： 对于生产环境或需要长期维护的项目，选择一个LTS版本的CMake可能是一个好的选择，因为它会获得更长时间的bug修复和支持。

多种Linux下CMake的安装方法

以下将详细介绍在Linux系统中安装CMake的几种主要方法。

方法一：使用系统包管理器安装（推荐）

这是最简单、最安全且推荐的安装方式。包管理器会自动处理依赖关系，并且便于日后的更新和卸载。

1. Debian/Ubuntu/Linux Mint 系统 (使用APT)

1. 更新包列表：

   在安装任何新软件之前，始终建议先更新系统的包列表，以确保获取到最新的软件信息和依赖项。

   sudo apt update

2. 安装CMake：

   执行以下命令安装CMake。

   sudo apt install cmake

   系统会提示您确认安装，输入y并回车即可。

3. 验证安装：

   安装完成后，检查CMake的版本以确认安装成功。

   cmake --version

提示：获取最新版CMake
APT仓库中的CMake版本可能不是最新的。如果需要更新的版本，可以添加Kitware的官方APT仓库：

wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | sudo apt-key add -
sudo apt-add-repository 'deb https://apt.kitware.com/ubuntu/ <DISTRIBUTION_CODE_NAME> main'
sudo apt update
sudo apt install cmake

请将<DISTRIBUTION_CODE_NAME>替换为您Ubuntu发行版的代号（例如focal, jammy等）。您可以通过lsb_release -cs命令查看。

2. RHEL/CentOS/Fedora 系统 (使用YUM/DNF)

对于基于RPM的系统，您可以使用yum（较旧的CentOS/RHEL）或dnf（较新的Fedora/CentOS 8+/RHEL 8+）。

1. 更新包列表：

   sudo dnf check-update # 或 sudo yum check-update

2. 安装CMake：

   sudo dnf install cmake # 或 sudo yum install cmake

   系统会提示您确认安装，输入y并回车即可。

3. 验证安装：

   cmake --version

3. Arch Linux 系统 (使用Pacman)

1. 更新系统：

   sudo pacman -Syu

2. 安装CMake：

   sudo pacman -S cmake

3. 验证安装：

   cmake --version

方法二：从预编译二进制包安装

如果您需要特定版本的CMake，或者您使用的Linux发行版没有提供最新版本，或者您没有root权限，可以考虑从官方网站下载预编译的二进制包。

1. 下载二进制包：

   访问CMake官方下载页面：cmake.org/download/。找到适用于您Linux系统架构（通常是x86_64）的最新版本二进制分发.tar.gz文件，例如cmake-x.y.z-linux-x86_64.tar.gz。

   您也可以使用wget或curl在终端中下载：

   wget https://cmake.org/files/v3.25/cmake-3.25.1-linux-x86_64.tar.gz # 将URL替换为最新版本

2. 解压文件：

   将下载的压缩包解压到您希望安装的目录。例如，您可以解压到/opt/目录（需要root权限）或您用户主目录下的某个目录（例如~/tools/）。

   sudo tar -zxvf cmake-3.25.1-linux-x86_64.tar.gz -C /opt/ # 解压到/opt/
   # 或者：
   # mkdir ~/tools
   # tar -zxvf cmake-3.25.1-linux-x86_64.tar.gz -C ~/tools/

   解压后，您会得到一个名为cmake-x.y.z-linux-x86_64的目录。

3. 配置环境变量PATH：

   为了让系统能够找到新安装的CMake可执行文件，您需要将其bin目录添加到系统的PATH环境变量中。打开您的shell配置文件，例如~/.bashrc（Bash用户）或~/.zshrc（Zsh用户），并在文件末尾添加以下行：

   # 以/opt/为例
   export PATH="/opt/cmake-3.25.1-linux-x86_64/bin:$PATH"
   
   # 或者以~/tools/为例
   # export PATH="$HOME/tools/cmake-3.25.1-linux-x86_64/bin:$PATH"

   注意： 请确保将cmake-3.25.1-linux-x86_64替换为您实际解压的目录名称和版本号。

4. 使环境变量生效：

   保存文件后，执行以下命令使更改立即生效，或者关闭并重新打开终端。

   source ~/.bashrc # 或 source ~/.zshrc

5. 验证安装：

   cmake --version

   您应该能看到您刚刚安装的CMake版本信息。

方法三：从源码编译安装

这是最灵活但也最复杂的方法。它允许您完全控制CMake的编译选项，但需要安装编译器和构建工具。

1. 安装必要的编译工具：

   您需要安装C++编译器和构建工具，例如build-essential（Debian/Ubuntu）或Development Tools（CentOS/Fedora）。

   • Debian/Ubuntu：

     sudo apt update
     sudo apt install build-essential libssl-dev

     libssl-dev提供SSL支持，是CMake某些特性所必需的。

   • CentOS/Fedora：

     sudo dnf groupinstall "Development Tools" # 或 sudo yum groupinstall "Development Tools"
     sudo dnf install openssl-devel # 或 sudo yum install openssl-devel

2. 下载CMake源码包：

   访问CMake官方下载页面（cmake.org/download/），下载最新版本的源码.tar.gz文件，例如cmake-x.y.z.tar.gz。

   wget https://cmake.org/files/v3.25/cmake-3.25.1.tar.gz # 将URL替换为最新版本

3. 解压源码包：

   tar -zxvf cmake-3.25.1.tar.gz
   cd cmake-3.25.1

4. 创建构建目录并配置：

   通常建议在一个单独的构建目录中进行编译，以保持源码目录的清洁。

   mkdir build
   cd build
   ../bootstrap --prefix=/usr/local # 指定安装路径为/usr/local

   bootstrap脚本会生成Makefile。--prefix参数用于指定CMake的安装路径。如果您想安装到自定义目录，例如/opt/cmake-latest/，则将/usr/local替换为该路径。

   注意： 如果您在执行bootstrap时遇到SSL相关错误，可能需要确保libssl-dev或openssl-devel已正确安装。

5. 编译：

   使用make命令编译CMake。-j参数可以指定并行编译的线程数，通常设置为CPU的核心数，可以加速编译过程。

   make -j$(nproc) # $(nproc) 会自动获取CPU核心数

   这个过程可能需要一些时间，具体取决于您的硬件性能。

6. 安装：

   编译完成后，执行安装命令。如果您的--prefix是系统路径（如/usr/local），则需要使用sudo。

   sudo make install

7. 验证安装：

   cmake --version

   如果之前没有将/usr/local/bin添加到PATH，并且您没有使用root用户安装到/usr/local，您可能需要手动将其添加到PATH变量中，方法与二进制安装相同。

安装后的验证与基本使用

验证CMake是否可用

在任何安装方法完成后，最关键的一步是验证CMake是否正确安装并可以在终端中访问。只需再次运行：

cmake --version

确保输出显示您期望的CMake版本信息。

如果遇到“cmake: command not found”：

• 检查拼写： 确保命令没有拼写错误。
• 环境变量PATH： 如果是手动安装（二进制包或源码），很可能是CMake的可执行文件路径没有添加到您的PATH环境变量中，或者添加后没有source您的shell配置文件。请返回检查并修正。
• 安装失败： 如果通过包管理器安装也出现此问题，可能是安装过程未能成功完成，可以尝试重新安装或检查安装日志。

如何使用CMake构建一个简单的C++项目？

让我们通过一个“Hello CMake”的例子来演示CMake的基本使用流程。

1. 创建项目目录和源文件：

   mkdir hello_cmake
   cd hello_cmake
   touch main.cpp CMakeLists.txt

2. 编辑main.cpp：

   // main.cpp
   #include <iostream>
   
   int main() {
       std::cout << "Hello from CMake!" << std::endl;
       return 0;
   }

3. 编辑CMakeLists.txt：

   # CMakeLists.txt
   cmake_minimum_required(VERSION 3.10) # 要求最低CMake版本
   
   project(HelloWorld CXX) # 定义项目名称和语言
   
   add_executable(hello_app main.cpp) # 添加一个可执行文件，名为hello_app，源文件是main.cpp

   这份CMakeLists.txt文件非常简洁，它告诉CMake：

   • 项目需要CMake 3.10或更高版本。
   • 项目名称是HelloWorld，使用C++语言。
   • 生成一个名为hello_app的可执行文件，源文件是main.cpp。
4. 创建构建目录并生成构建文件：

   通常，我们会在一个单独的build目录中生成构建文件，以避免污染源码目录。

   mkdir build
   cd build
   cmake ..

   cmake ..命令会读取上一级目录（..）中的CMakeLists.txt文件，并在此build目录中生成Makefile（或其他构建文件，取决于您的生成器配置）。您会看到CMake输出一些配置信息。

5. 编译项目：

   在build目录中，使用生成的Makefile进行编译。

   make

   如果一切顺利，您将看到编译器（例如g++）编译main.cpp的输出，并在build目录中生成名为hello_app的可执行文件。

6. 运行程序：

   ./hello_app

   您应该会看到输出：Hello from CMake!

CMake的升级与卸载

如何升级CMake？

升级CMake的方法取决于您的原始安装方式：

• 通过包管理器安装：

  这是最简单的升级方式。只需运行系统的更新命令，包管理器会自动检查并安装新版本的CMake（如果仓库中有）。

  • Debian/Ubuntu：

    sudo apt update
    sudo apt upgrade cmake

  • CentOS/Fedora：

    sudo dnf update cmake # 或 sudo yum update cmake

  • Arch Linux：

    sudo pacman -Syu

• 从预编译二进制包或源码编译安装：

  这种情况下，升级本质上是重新安装新版本。您需要：

  1. 下载新版本的二进制包或源码包。
  2. 按照相应的安装步骤（方法二或方法三）重新执行一遍。
  3. 如果新版本安装在与旧版本相同的路径，它将覆盖旧版本。如果安装在不同路径，请确保更新您的PATH环境变量以指向新版本的bin目录。

如何卸载CMake？

卸载CMake的方法也取决于您的原始安装方式：

• 通过包管理器安装：

  使用包管理器的移除命令即可。

  • Debian/Ubuntu：

    sudo apt remove cmake # 卸载CMake，保留配置文件
    sudo apt purge cmake # 彻底卸载CMake及其配置文件

  • CentOS/Fedora：

    sudo dnf remove cmake # 或 sudo yum remove cmake

  • Arch Linux：

    sudo pacman -R cmake

• 从预编译二进制包安装：

  只需删除您解压CMake的整个目录即可。例如，如果您解压到/opt/cmake-x.y.z/，则执行：

  sudo rm -rf /opt/cmake-x.y.z/

  然后，记得从您的shell配置文件（如~/.bashrc）中移除相应的export PATH=...行，并source使其生效。

• 从源码编译安装：

  如果您在编译时使用了--prefix参数并记得编译目录，可以回到该目录执行：

  cd path/to/cmake-x.y.z/build
  sudo make uninstall

  但make uninstall并非总是可靠或完整的，更稳妥的方式是手动删除CMake安装到的目录（例如/usr/local/bin/cmake、/usr/local/share/cmake-...等），并从PATH环境变量中移除相关路径。

通过本文的详细介绍，相信您已经对在Linux系统上安装和使用CMake有了全面而深入的理解。无论您是C/C++开发的新手还是经验丰富的开发者，掌握CMake都将是提升开发效率和项目管理能力的关键一步。