VS Code+MinGW 搭建Windows C++开发环境

2023-12-21 06:25:15

官方文档是最香香的:https://code.visualstudio.com/docs/cpp/config-mingw

1、一些非常不友好的名词

1.1 什么TMD是 GNU、MinGW、GCC、gcc、g++?

好奇的可以看看,捋清楚他们之间的关系

小总结:

  • GNU 对于目标是WIndows开发的人来说不需要懂
  • MinGW(Minimalist GNU for Windows):MinGW 是一个允许在Windows上使用GNU工具链的开发工具集,使开发者能够在Windows平台上进行类Unix环境的开发。我们只需要知道,它提供了一大堆编译器(GCC, GNU Compiler Collection)
  • gcc,用于编译C语言源代码的编译器
  • g++:用于编译C++语言源代码的编译器

简而言之,MinGW 是一个工具集,它允许在Windows上使用 GNU 工具链进行开发。GCC 是 GNU 工具链中的主要组件,而 gcc 和 g++ 是 GCC 的其中两个编译器,分别用于编译C和C++代码。

我们需要从中获取编译器g++,调试器gdb

1.2 MSVC

这是Visual Stuidio(IDE)用的编译器,在VSCode中,如果选择MSVC作为编译器,结果就是生成一个对应VS版本的.sln解决方案,后面就不说了吧 用Visual Studio 2022 打开就行。

如果是纯VS Code环境开发C++的话,毫无疑问还是要用 g++

2、获取g++编译器

3、VS Code单文件编译和调试流程

篇幅考虑,下载VS Code就略过了

3.1 安装插件

  • C/C++
  • C/C++ Themes
  • Chinese(Simplified)

用途可以自己看插件说明

C/C++插件需要指定编译器路径,否则智能提示可能不管用

  • ctrl+shift+p -> 输入C/C++ -> 选择编辑配置(UI)
    在这里插入图片描述
  • 指定编译器路径,下拉菜单中一般都可以直接选择,VSCode中的这个插件会自动检查一遍环境变量,找到所有可用的编译器
    (还可以看看这里的其他设置,可以发现这里就是设置C++相关配置的)
    在这里插入图片描述
  • 如果选择用编辑配置(json),则会自动在.vscode文件夹下生成一个c_cpp_properties.json,这跟UI编辑界面的内容是一样的,并且在这两个地方任意一个地方进行改动后,另一个也会相应的发生变化。

3.2 单个源文件编译运行

  • 新建一个空白文件夹,写个hello world测试代码
    在这里插入图片描述
  • 直接点击运行(菜单栏运行或者三角图标)
    在这里插入图片描述
  • 选择g++.exe
    在这里插入图片描述
  • 运行成功,终端里面有Hello World!输出
    在这里插入图片描述

3.3 tasks.json 指导编译

此时可能注意到根目录下新增了一个文件.vscode/tasks.json,这是C/C++插件默认帮我们生成的,必须有这个文件才能编译

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++.exe 生成活动文件",
            "command": "E:\\MingGW\\mingw64\\bin\\g++.exe",
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "调试器生成的任务。"
        }
    ],
    "version": "2.0.0"
}

它帮你简化了很多操作,这里的行为就相当于你在命令行里输入:

g++.exe fdiagnostics-color=always -g main.cpp -o main.exe
.\main.exe

tasks.json 是 Visual Studio Code(VSCode)中用于配置任务(tasks)的文件。任务是指一系列在 VSCode 中可以执行的操作,通常是编译、构建、运行程序。tasks.json 文件允许你定义这些任务的配置信息。

字段解释:

  • version: 指定 tasks.json 文件的版本。通常是 “2.0.0”。
  • tasks: 一个数组,包含了任务的配置信息。
  • label: 任务的标签,用于在 VSCode 中标识任务。
  • type: 任务的类型,通常是 “shell”(使用命令行)或 “process”(使用可执行程序)。
    - command: 执行任务的命令或可执行文件。这里就是调用g++.exe
    - args: 传递给命令或可执行文件的参数。这里是传给g++的编译命令
  • options: 任务的配置选项,例如设置工作目录cwd等。

3.4 launch.json 调试

  • 调试,需要创建launch.json,并指定调试相关配置属性,比如调试的目标可执行文件,调试采用的调试器路径等

  • 首先进入调试界面,创建launch.json,弹出的下拉菜单中选择C++(GDB)
    在这里插入图片描述

  • 默认创建好的文件中,右下角选择添加配置->(gdb)启动,这会为你生成默认的配置信息
    在这里插入图片描述

  • 默认生成的launch.json内容如下

    {
        // 使用 IntelliSense 了解相关属性。 
        // 悬停以查看现有属性的描述。
        // 欲了解更多信息,请访问: https://go.microsoft.com/fwlink/?linkid=830387
        "version": "0.2.0",
        "configurations": [
            {
                "name": "(gdb) 启动",
                "type": "cppdbg",
                "request": "launch",
                "program": "输入程序名称,例如 ${workspaceFolder}/a.exe",
                "args": [],
                "stopAtEntry": false,
                "cwd": "${fileDirname}",
                "environment": [],
                "externalConsole": false,
                "MIMode": "gdb",
                "miDebuggerPath": "/path/to/gdb",
                "setupCommands": [
                    {
                        "description": "为 gdb 启用整齐打印",
                        "text": "-enable-pretty-printing",
                        "ignoreFailures": true
                    },
                    {
                        "description": "将反汇编风格设置为 Intel",
                        "text": "-gdb-set disassembly-flavor intel",
                        "ignoreFailures": true
                    }
                ]
            }
        ]
    }
    

    字段解释:

    • version: launch.json 文件的版本。通常是 “0.2.0”,表示使用的 JSON 配置文件格式版本。
    • configurations: 包含一个数组,每个元素是一个调试配置。
      • name: 调试配置的名称,用于在 VSCode 中标识不同的调试配置。
      • type: 调试器的类型。在这个配置中,是 “cppdbg”,表示使用 C++ 调试器。
      • request: 调试请求的类型。在这里是 “launch”,表示启动调试会话。
      • program待调试的程序的路径。须手动设置为"${workspaceFolder}/main.exe",表示工作区中main.exe。
      • args: 启动程序时传递的命令行参数。这里为空数组,表示没有附加的命令行参数。
      • stopAtEntry: 是否在程序入口处停止。在这里是 false,表示不停在程序入口处。
      • cwd: 启动程序时的工作目录。这里使用 ${fileDirname},表示使用当前文件所在的目录作为工作目录。
      • environment: 启动程序时使用的环境变量。这里是空数组,表示没有特定的环境变量设置。
      • externalConsole: 是否使用外部控制台。在这里是 false,表示使用 VSCode 的内部控制台。
      • MIMode: 调试器的模式。在这里是 “gdb”,表示使用 GDB(GNU Debugger)。
      • miDebuggerPathGDB 可执行文件的路径。改为 "E:\\MingGW\\mingw64\\bin\\gdb.exe",你需要将其替换为你系统中 GDB 的实际路径。
      • setupCommands: 一组 GDB 初始化命令,用于在调试会话开始时执行。这里包含了两个命令,分别用于启用漂亮打印和设置反汇编风格为 Intel。
  • 设置好之后,就可以开始断点调试了
    在源代码文件中打断点(F9),然后运行->启动调试(F5),也可以在三角按钮那里选择调试
    在这里插入图片描述

3.5 setting.json 设置

settings.json 是 VSCode中用于配置编辑器的各种行为和选项。这个文件存储了用户自定义的设置,以便在不同的项目和工作区中重用。VS Code会实时的把你修改过的设置写入到setting.json

  • 打开VSCode的设置
    在这里插入图片描述
  • 设置有两个作用域,一个是本机用户,另一个是当前项目的,用户的作用域的setting.json文件是存放在C盘Users/username/AppData/Roaming/Code/user/中的,而作用域为当前项目的则是存放在项目根目录的.vscode/里面。
    在这里插入图片描述
  • 你在设置里面进行的设置更改,会实时的写入到对应作用域的setting.json文件中,两者互相反射

4 CMake 使用

必须掌握的技能,目前github上开源项目几乎都采用CMake来维护,不会使用则寸步难行,学会CMake之后,其他的构建工具都简简单单,比如Premake。

需要:

  • 手动下载CMake:https://cmake.org/download/,并配置环境变量。检查是否安装成功,可以在命令行中输入命令
    cmake --version
    
  • 在VSCode中,设置CMake路径
  • 需要安装插件:CMake、CMake Tools

掌握CMake Tools: 强烈建议看看CMake Tools插件所指定的官方文档,进行学习。
简单来说,有了这个插件,你就不用编写task.json,launch.json了。下面是一个简单的使用案例
在这里插入图片描述

4.1 创建一个CMake Hello World 项目

创建一个文件夹,用VS Code打开,Ctrl+Shift+P输入CMake,选择Quick Start
在这里插入图片描述
输入项目名称,比如HelloProject,然后选择C++项目可执行文件
在这里插入图片描述
这会创建一个基本的CMake示例项目,包含一个源文件main.cppCMakeLists.txt(它会告诉CMake Tools插件如何构建你的项目)

生成可执行文件之前,还需要做2步准备工作

4.2 CMake:Select a Kit 选择工具包

在使用CMake Tools扩展构建项目之前,您需要配置它以了解系统上的编译器。通过扫描“工具包”来完成这个配置。一个工具包代表一个工具链,这是用于构建项目的编译器、链接器和其他工具

打开命令面板(Ctrl+Shift+P),运行“CMake: Select a Kit”。该扩展将自动扫描您计算机上的工具包,并创建找到的系统上的编译器列表。这里我们选择GCC 8.1.0这个,路径太长,实际上这个就是g++.exe
在这里插入图片描述
你可以在侧边栏看到你选择的kits
在这里插入图片描述

注意,CMake默认是选择MSVC编译器(如果你有)。所以第一次,一定要手动选kit,如果你选择自动配置CMake项目,当CMake Tools看到CMakeLists.txt,就一顿操作给你build文件夹搞出来了,里面躺着一个.sln- - 。在你这一套配置走下来后,之后的自动配置就用的gcc了

4.3 CMake:Select Variant 选择变量

这里的Variant也可以叫做变体,其实就是构建类型。一个Variant包含了构建项目的指令。默认情况下,CMake Tools扩展提供了四个Variant,分别对应于四种默认的构建类型:

  • Debug: 禁用优化并包含调试信息。
  • Release: 包含优化但没有调试信息。
  • MinRelSize: 优化以减小大小,没有调试信息。
  • RelWithDebInfo: 优化以提高速度,并包含调试信息。

要选择一个Variant,打开命令面板(Ctrl+Shift+P),运行“CMake: Select Variant”命令。
在这里插入图片描述
这里我选择Debug

4.4 CMake:Configure 生成配置文件

配置项目是指生成适用于选定kitvariant的构建系统所需的文件。这些文件包含构建项目所需的编译器、链接器、库等设置。一旦配置完成,您就可以继续使用其他 CMake 命令进行构建编译、链接调试该项目。

运行 CMake: Configure 命令来配置项目。这会产生一个build文件夹,里面放的是构建该项目所需要的所有配置信息

4.5 CMake:Build 生成可执行文件

终于可以build了,运行CMake:Build 或者在下边栏点击这个生成(build),中文版翻译为生成,作用就是生成可执行文件,默认是build all,因为大型项目可能有多个生成目标,可能有些是静态库、动态库、.exe,你可以选择只生成某一个,也可以生成所有。
在这里插入图片描述
在build里面可以找到.exe文件,运行它即可
在这里插入图片描述

4.6 CMake::Debug 调试

要运行和调试项目,请打开 main.cpp 并在 std::cout 行设置断点(F9),然后打开命令面板运行 CMake: Debug 即可

文章来源:https://blog.csdn.net/Motarookie/article/details/135083683
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。