windows下cmake的小白级入门使用教程(hello world)

迷南。 2023-10-12 15:19 11阅读 0赞

想学习cmake，基于惯性思维，想先跑通一个“hello world”的例子，奈何网上教程一大把，有用的教程破费功夫寻找。大部分教程都没有从新电脑(重装系统后的电脑)的角度讲述步骤。

为了得到干净的电脑环境，研究了一段时间VMware虚拟机，并写了几篇文章，感兴趣的读者可移步阅读：

VMware虚拟机安装win10系统教程： [VMware虚拟机安装win10系统教程\_西晋的no1的博客-CSDN博客][VMware_win10_no1_-CSDN]

经过几天的努力将cmake的“hello world”整个步骤从新电脑(重装系统后的电脑，基于VMware虚拟机)的角度跑通了，并将下述过程记录进行了验证，结果是可行的。

下述内容有些来自于其他博客，由于资料查询的比较多，无法对应出处，故不单列出处了，在此对引用内容的作者们表示感谢。

## **一、Cmake 介绍** ##

CMake是一个跨平台的安装（编译）工具，可以用简单的语句来描述所有平台的安装(编译过程)。他能够输出各种各样的makefile或者project文件。只是 CMake 的组态档取名为 CMakeLists.txt。Cmake 并不直接建构出最终的软件，而是产生标准的建构档（如 Unix 的 Makefile 或 Windows Visual C++ 的 projects/workspaces），然后再依一般的建构方式使用。

Makefile想必大家都不陌生吧，它能够解决我们的自动化编译问题，大多是IDE软件都集成了make，譬如 Visual C++的 nmake、linux 下的 GNU make、Qt 的 qmake 等等。

不同的IDE所集成的make工具所遵循的规范和标准都不同，也就导致其语法、格式不同，也就不能很好的跨平台编译，会再次使得工作繁琐起来

那么cmake为了解决这个问题而诞生了，其允许开发者指定整个工程的编译流程，在根据编译平台，生成本地化的Makefile和工程文件，最后用户只需make编译即可

简而言之，可以把cmake看成一款自动生成 Makefile的工具，所以编译流程就变成了：cmake—>make–>用户代码–>可执行文件。

![7ad7a7c5f8584a16bdd86de0b65214cf.png][]

## **二、下载安装Cmake，配置环境变量，检验安装是否正常** ##

### **1.****下载Cmake** ###

下载地址： [Download | CMake][Download _ CMake]  
点击链接进入cmake官网下载网页，下载最新稳定版即可（Latest Release）

![fdd7c9ad9c42475284c33faf42413a61.png][]

我这里下载的是cmake-3.26.4-windows-x86\_64.msi（PS: 根据个人电脑windows系统位数下载对应的版本）

若不想安装，可直接下载压缩包版本cmake-3.26.4-windows-x86\_64.zip。

### **2.****安装****cmake****，配置环境变量** ###

CMake的安装非常简单。压缩包版本直接解压即可，安装版本也可一直点击下一步进行安装。为了使用方便，可将CMake配置到环境变量中，当然，这一步也可以在安装过程中设置。另外需要注意的是为了避免不必要的麻烦，路径中最好不要包括中文字符。下面简单描述一下安装过程。

1.双击下载的安装包，进入安装界面，点击\[Next\]。

![049c36dfb45d48029114da2837b4887c.png][]

2.勾选同意许可后，点击\[Next\]。

![c872af80e6034fb3afbd9c599b66c7c8.png][]

3.可在此处选择将CMake路径添加到环境变量中，并且创建CMake GUI程序的桌面快捷方式。然后点击\[Next\]。

![293d717f6b9a43b08c8e12231db3c4a1.png][]

4.可在此处自定义安装目录，设置好后点击\[Next\]。

![36fb94548ad84bdabbdfdb58df5fe618.png][]

5.开始安装，安装完成后点击\[Next\]。

![8a529bbde9a24582914ce6d949e5a775.png][]

6.安装完成，点击\[Finish\]，结束安装过程。

![0082ebb01d194ecfa5fa6754793bb505.png][]

### **3.****检验安装是否正常** ###

安装完成后，即可使用CMake了。在命令行中输入"cmake --version"，可看到如下图所示的输出。

![5e4665f7c97440958ea4d1c2da0d9893.png][]

## **三、下载安装MinGW，配置环境变量，检验安装是否正常** ##

cmake并不能完成整个工程的编译，cmake会输出makefile文件，我们需要用这个生成的makefile进行make编译。那就需要在windows环境中安装MinGW。

### **1.****下载****MinGW** ###

到页面： [MinGW-w64 - for 32 and 64 bit Windows - Browse Files at SourceForge.net][] 下载离线安装包

![db332903d1d8441b81f3b09d23879754.png][]

我下载了x86\_64-posix-sjlj的压缩包。

### **2.****安装****MinGW** ###

将下载下来的x86\_64-posix-sjlj压缩包解压缩便得到了mingw64。

![97f8a0bff69940e6aef7025b88cb3fd0.png][]

可以看到，这个是可以直接用的版本了

![717f0dc25efb477995130956b15b9e89.png][]

### **3.****配置环境变量** ###

直接将/bin路径添加到环境变量中即可。

![8e601a8056964e59a4794c5483b2a058.png][]

在命令行下，g++ --version\\gcc --version命令有效

![e021c04409c5488ba44cd28b2727b5c0.png][]

由于我们需要在window下直接输入make，就可以识别makefile并且自动编译，可以将MinGW安装路径bin文件下的mingw32-make.exe复制一份并重命名为make.exe。

**注意：**一定要复制一份再重命名，否则后续会出现其他问题

![ded9df26314a431ebbe345ab7674f835.png][]

### **4.****检验安装是否正常** ###

打开cmd输入make -version，出现如下信息表示安装成功。

![ab3e099e98464a9a82ace88f62b20718.png][]

## **四、使用Cmake编译一个简单的小工程** ##

新建一个文件夹（路径中不要有中文），在该文件夹中新建两个文件CMakeLists.txt和hello\_cmake.c，两个文件内容如下：

CMakeLists.txt

cmake_minimum_required(VERSION 3.0)
    project (hello_cmake)
    add_executable(hello_cmake hello_cmake.c)

第一行代码指定了构建项目所需的最低CMake版本。

第二行指定了工程的名字，随后输出的exe可执行文件也会和它同一个名称 -

project 命令用于设置工程的名称,括号中的参数 hello\_cmake 便是我们要设置的工程名称;设置工程名称并不是强制性的,但是最好加上。

第三行表示项目需要构建一个exe可执行文件，并且它由hello\_cmake.c编译而成 -

在本例中传入了两个参数,第一个参数表示生成的可执行文件对应的文件名,第二个参数表示对应的源文件;表示需要生成一个名为 hello\_cmake 的可执行文件,所需源文件为当前目录下的 hello\_cmake.c。

hello\_cmake.c

#include <stdio.h>
    	 
    int main(int argc, char *argv[])
    {
    	printf("Hello CMake!\n");
    	getchar();
    	return 0;
    }

![dfa1e7dd258344f5943ffc2fa16a5fe8.png][]

打开cmd进入当前目录，输入如下命令行。

mkdir build
    cd build
    cmake -G "MinGW Makefiles" ..
    make
    hello_cmake.exe

**注：**关键的命令 cmake -G "MinGW Makefiles" .. 。若遇到用CMake构建c/c++程序时报错,可尝试把编译时的cmake .改为：cmake -G "MinGW Makefiles" .

如下图所示：

![20965067266c42bbbe9b6450aff04e26.png][]

[VMware_win10_no1_-CSDN]: https://blog.csdn.net/xijinno1/article/details/131198516
[7ad7a7c5f8584a16bdd86de0b65214cf.png]: https://img-blog.csdnimg.cn/7ad7a7c5f8584a16bdd86de0b65214cf.png
[Download _ CMake]: https://cmake.org/download/
[fdd7c9ad9c42475284c33faf42413a61.png]: https://img-blog.csdnimg.cn/fdd7c9ad9c42475284c33faf42413a61.png
[049c36dfb45d48029114da2837b4887c.png]: https://img-blog.csdnimg.cn/049c36dfb45d48029114da2837b4887c.png
[c872af80e6034fb3afbd9c599b66c7c8.png]: https://img-blog.csdnimg.cn/c872af80e6034fb3afbd9c599b66c7c8.png
[293d717f6b9a43b08c8e12231db3c4a1.png]: https://img-blog.csdnimg.cn/293d717f6b9a43b08c8e12231db3c4a1.png
[36fb94548ad84bdabbdfdb58df5fe618.png]: https://img-blog.csdnimg.cn/36fb94548ad84bdabbdfdb58df5fe618.png
[8a529bbde9a24582914ce6d949e5a775.png]: https://img-blog.csdnimg.cn/8a529bbde9a24582914ce6d949e5a775.png
[0082ebb01d194ecfa5fa6754793bb505.png]: https://img-blog.csdnimg.cn/0082ebb01d194ecfa5fa6754793bb505.png
[5e4665f7c97440958ea4d1c2da0d9893.png]: https://img-blog.csdnimg.cn/5e4665f7c97440958ea4d1c2da0d9893.png
[MinGW-w64 - for 32 and 64 bit Windows - Browse Files at SourceForge.net]: https://sourceforge.net/projects/mingw-w64/files/?source=navbar
[db332903d1d8441b81f3b09d23879754.png]: https://img-blog.csdnimg.cn/db332903d1d8441b81f3b09d23879754.png
[97f8a0bff69940e6aef7025b88cb3fd0.png]: https://img-blog.csdnimg.cn/97f8a0bff69940e6aef7025b88cb3fd0.png
[717f0dc25efb477995130956b15b9e89.png]: https://img-blog.csdnimg.cn/717f0dc25efb477995130956b15b9e89.png
[8e601a8056964e59a4794c5483b2a058.png]: https://img-blog.csdnimg.cn/8e601a8056964e59a4794c5483b2a058.png
[e021c04409c5488ba44cd28b2727b5c0.png]: https://img-blog.csdnimg.cn/e021c04409c5488ba44cd28b2727b5c0.png
[ded9df26314a431ebbe345ab7674f835.png]: https://img-blog.csdnimg.cn/ded9df26314a431ebbe345ab7674f835.png
[ab3e099e98464a9a82ace88f62b20718.png]: https://img-blog.csdnimg.cn/ab3e099e98464a9a82ace88f62b20718.png
[dfa1e7dd258344f5943ffc2fa16a5fe8.png]: https://img-blog.csdnimg.cn/dfa1e7dd258344f5943ffc2fa16a5fe8.png
[20965067266c42bbbe9b6450aff04e26.png]: https://img-blog.csdnimg.cn/20965067266c42bbbe9b6450aff04e26.png