代码收藏家技术教程 2023-01-04

Windows 10 下 VSCode 与 CMake 编译：解决交叉编译的坑（第一部分）

1、工具链安装

工具链版本如下

C:\Users\Lenovo>cmake -version
cmake version 3.24.2

C:\Users\Lenovo>mingw32-make -v
GNU Make 4.2.1 Built for x86_64-w64-mingw32

若没有以上工具则进行安装，将bin文件加入到环境变量中，注意：有的交叉编译器在安装时选择自动加入环境变量可能并不会加入，还是需要手动加入环境变量，本章首先介绍MinGW编译器，其环境变量如图中所示，位于D盘bin目录下
该目录下包含了mingw的一系列工具链
包括mingw的make文件，mingw32-make（在运行makefile时要使用mingw32-make而不是make）

还有mingw的gcc文件，用于编译.c文件生成可执行文件

它们的关系是这样的：make用于执行Makefiles，Makefiles中包含了一系列的gcc语句用于编译连接，因此make相当于借助makefiles执行一系列gcc指令的指令。（这里的make代表了一系列的make工具，对于mingw是mingw32-make，对于其他工具可能是其他名字。gcc也同理，这里是x86_64-w64-mingw32-gcc）

一个小探究，这里发现mingw的bin文件夹下除了x86_64-w64-mingw32-gcc还有一个gcc文件，但当我们在cmd中查看他们各自的版本时发现提示是一样的

C:\Users\Lenovo>gcc -v Using built-in specs. COLLECT_GCC=gcc
COLLECT_LTO_WRAPPER=D:/mingw64/bin/…/libexec/gcc/x86_64-w64-mingw32/8.1.0/lto-wrapper.exe
Target: x86_64-w64-mingw32

C:\Users\Lenovo>x86_64-w64-mingw32-gcc -v Using built-in specs.
COLLECT_GCC=x86_64-w64-mingw32-gcc
COLLECT_LTO_WRAPPER=D:/mingw64/bin/…/libexec/gcc/x86_64-w64-mingw32/8.1.0/lto-wrapper.exe
Target: x86_64-w64-mingw32

应当是都被重定向到了同一个可执行文件

2、安装Vscode插件

C/C++
Cmake
Cmake Tools

3、CMake介绍

CMake是一个跨平台的Makefile生成工具
依赖的文件是CMakeLists.txt，其作用简单归结为：

cmake执行CMakeLists.txt生成Makefiles，然后make执行Makefiles，调用Makefiles中一系列gcc编译生成可执行的目标文件

在这个过程中，make有不同的工具，gcc也有不同的工具，因此在整个工具链中需要进行配置。例如如果是生成windows可执行文件，Cmake就要配置生成MinGW Makefiles，执行Makefiles要选择mingw32-make，编译器要选择x86_64-w64-mingw32-gcc

4、VScode中CMake的使用

shift+ctrl+P:并输入如下指令
cmake:quick start

为本工程开启CMake tools

然后就会看到cmake tools在vscode中的UI
可以点击这里

来进行配置编译器的选择，比如mingw编译器或者arm交叉编译器

5、操作流程（简易版Cmake，无文件层次）

5.1创建文件夹并在VScode中打开

在桌面上新建了一个空文件夹test_hello，并在VScode中打开文件夹

5.2创建文件hello.c

hello.c

#include<stdio.h>
int main(){
    printf("HELLO\n");
    return 0;
}

5.3创建文件CMakeLists.txt

CMakeLists.txt

#cmake使用#注释
cmake_minimum_required(VERSION 3.0)#指定最低版本，不超过前面查看的当前版本
project(hello_simple)#指定当前项目名称
add_executable(hello hello.c)#指定生成目标、源文件

5.4配置VScode插件CMakeTools选项

进入用户设置

选择CMakeTools设置

可以看到生成文件的默认目录是会在当前文件夹下创建一个build文件夹，生成文件都生成在这个build文件夹中

此外还有源代码目录选择，这个和build一样，都先默认不设置

CMake生成器（Generator）配置。
CMake不编译或链接任何源文件，它使用生成器为构建系统创建配置文件。
相当于在终端（cmd或者powershell）中输入cmake -G后面的参数，例如cmake -G “MinGW Makefiles”

在终端输入

cmake -help

可以看到-G可选参数，其中常见的有这几种。也就是说在上述Cmake:Generator中可选这些生成器，*号表示默认的生成器

5.5开启CMakeTools的UI并选择编译器

shift+ctrl+P

弹出的窗口输入：

cmake:quick start

并点击,会弹出来如下选择
第一次使用时推荐第一个，这个会在本机中扫描编译器和交叉编译器（前提是必须先添加到系统环境变量中，详见本章第一节），特别是遇到BC没出现的情况时，点击A后UI会自动启动，然后在窗口底部的这个位置可以点击选择编译器。
这里选择x86_64-w64-mingw32-gcc 构建windows系统的可执行文件，则生成文件是exe格式的。