用VSCode开发C++项目

写在前面最近在新学C++，又不想用VisualStudio那么庞大的IDE，VS体量稍微有那么点笨重（主要还是因为穷，没钱换电脑，目前的电脑开个VS要个两三分钟，所以就懒得用VS了。嘻嘻！）。下面步入正题。首先得明白VS只是一个编辑器，类似于记事本，本身是不能够进行任何程序语言开发的。只不过这个记事本可以安装插件，可以和命令行程序结合起来使用，使得它可以进行开发。那么在进行相应语言开发时自然少不了

文章共4,522字 · 阅读需要大约16分钟

一键AI生成摘要，助你高效阅读

问答

B&W+R&X

22820人浏览 · 2021-09-23 00:17:34

B&W+R&X · 2021-09-23 00:17:34 发布

写在前面

最近在新学C++，又不想用VisualStudio那么庞大的IDE，VS体量稍微有那么点笨重（主要还是因为穷，没钱换电脑，目前的电脑开个VS要个两三分钟，所以就懒得用VS了。嘻嘻！）。下面步入正题。
首先得明白VS只是一个编辑器，类似于记事本，本身是不能够进行任何程序语言开发的。只不过这个记事本可以安装插件，可以和命令行程序结合起来使用，使得它可以进行开发。那么在进行相应语言开发时自然少不了一顿相关配置操作。废话不多说，上步骤

准备工作

一、下载编译器

我这里使用的是mingw编译器。可参考VSCODE官方文档在Windows上使用GCC。

1、下载和安装MINGW编译器转至MSYS2网站。
我这里已经安装好了，就不再演示了。一定要记住安装路径，配置环境变量的时候会用上。一定要按照MYSY2网站上的安装提示安装，那些插件不知道哪些有用的就都安装上。

2、 配置环境变量
将Mingw-w64文件夹下的bin文件夹加入到系统环境变量中。下面以win10系统为例。

打开设置-系统
选择关于-高级系统设置
点击环境变量
选择Path-编辑
点击新建，将mingw安装目录下的mingw64的bin文件夹路径添加到path中。
点击确定，就完成了。
最后确定一下mingw是否成功安装，命令行输入

g++ --version
gdb --version

出现如下信息，则安装成功。
在这里插入图片描述

二、下载VSCODE

VSCODE已安装好，请到官网下载最新版

三、安装VSCODE C++相关插件

点击VSCODE左侧扩展插件图标，在出现的搜索栏中输入“C++”，选择“C/C++”。

四、新建工程

1、新建项目文件夹及主程序

在磁盘空间中新建一个test文件夹，右击选择用VSCODE打开。
在test下建立4个文件夹，如下图：

(build–放编译文件、include–放.h头文件、–lib放库文件、src–放源文件)
在src文件夹下新建main.cpp输入helloworld程序。

#include <iostream>
using namespace std;

int main()
{

    cout<<"Hello!World！"<<endl;
    system("pause");
    return 0;
}

2、创建.vscode文件夹

.vscode文件夹包括三个json类型文件，分别为c_cpp_properties.json文件（编译器路径设置和智能提示设置）、task.json文件（编译说明）、launch.json文件（调试设置）。

创建c_cpp_properties.json

按快捷键Ctrl+Shift+P打开命令搜索面板，选择“C/C++：编辑配置（UI）”，进入配置UI界面，并自动生成c_cpp_properties.json文件。

在这里插入图片描述

编译器路径选择刚刚安装的g++.exe的路径，智能提示模式选择gcc-x64。如下图：
在c_cpp_properties.json中添加includePath。如果不知道有哪些路径就将文章编译器安装路径下所有include文件夹全追加进去。
c_cpp_properties.json

创建Task.json文件

点击工具栏–终端–配置默认生成任务–选择”C/C++：g++.exe生成活动文件“，以生成task.json文件。
常用的Task.json文件如下。label为任务名，一般设置为build，command即选择什么编译器进行编译，一般选gcc或g++，args为编译的时候用到的参数，详细参数说明参考gcc/g++命令使用及编译原理一。

{
	"version": "2.0.0",
	"tasks": [
		{
			"type": "cppbuild",
			"label": "C/C++: g++.exe 生成活动文件",
			"command": "G:\\Tools\\Compiler\\MSYS2\\msys64installtion\\mingw64\\bin\\g++.exe",
			"args": [
				"-g",
				"${file}",
				"-fexec-charset=GBK",   // 处理mingw中文编码问题
                "-finput-charset=UTF-8",// 处理mingw中文编码问题，没有这俩中文显示会乱码
				"-o",
				"${fileDirname}\\${fileBasenameNoExtension}.exe"
			],
			"options": {
				"cwd": "${fileDirname}"
			},
			"problemMatcher": [
				"$gcc"
			],
			"group": {
				"kind": "build",
				"isDefault": true
			},
			"detail": "编译器: G:\\Tools\\Compiler\\MSYS2\\msys64installtion\\mingw64\\bin\\g++.exe"
		}
	]
}

创建launch.json文件

点击VSCODE左侧工具栏的调试按钮，点击“创建launch.json文件”。
选择“C/C++(GDB/LLDB)”
以下是我们常用到的launch.json文件。其中program参数，为生成的可执行文件名，一定要与tasks.json文件中指定生成的文件名相同。还有一个是preLaunchTask，一般也要与tasks.json文件中的label一致，一般都是build。如果采用CMakeLists.txt的方法，preLaunchTask参数就不用指定了，删除这个参数就行。但是program参数需要指定，指定的方式为绝对路径名。关于CMakeList的使用方法我还没搞懂，得再研究。

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "g++.exe - 生成和调试活动文件", // 配置名称，将会在启动配置的下拉菜单中显示
            "type": "cppdbg",                     // 配置类型，这里只能为cppdbg
            "request": "launch",                  // 请求配置类型，可以为launch（启动）或attach（附加）
            "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",// 将要进行调试的程序的路径
            "args": [],                          // 程序调试时传递给程序的命令行参数，一般设为空即可
            "stopAtEntry": false,                 // 设为true时程序将暂停在程序入口处，一般设置为false
            "cwd": "${fileDirname}",             // 调试程序时的工作目录，一般为${workspaceRoot}即代码所在目录
            "environment": [],
            "externalConsole": true,            // 调试时是否显示控制台窗口，一般设置为true显示控制台
            "MIMode": "gdb",
            "miDebuggerPath": "G:\\Tools\\Compiler\\MSYS2\\msys64installtion\\mingw64\\bin\\gdb.exe",// miDebugger的路径，注意这里要与MinGw的路径对应
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "C/C++: g++.exe 生成活动文件"// 调试会话开始前执行的任务，一般为编译程序，c++为g++, c为gcc
        }
    ]
}

3、运行生成任务

第一次运行程序需先运行生成任务，生成可执行文件。具体操作如下：

点击main.cpp，将其置于vscode主界面，使其成为活跃文件。
点击工具栏终端–运行生成任务。
出现如下提示即为生成成功。

4、调试程序

同样需要将main.cpp置为活动文件，按F5或点击左侧小虫子图标。同VS一样打断点，在左侧监视窗口添加表达式以监视变量的值。
在这里插入图片描述

5、完成

至此VSCODE调试单个C++文件已成功。

五、多文件调试（引入自定义头文件）

在include文件夹新建头文件“click.h”，代码如下:

#include<string>
using namespace std;
string record();

在lib文件夹下新建实现文件“click.cpp”，代码如下：

#include "click.h"
#include <string>
using namespace std;

string record()
{ 
    string str="中秋快乐！";
    return str;
}

将main.cpp文件改为如下：

#include <iostream>
#include "click.h"
using namespace std;

int main()
{

    cout<<"Hello!World！"<<endl;
    string str=record();
    cout<<str<<endl;
    system("pause");
    return 0;
}

调试。会发现main.cpp中“click.h文件找不到。
原因有二：
一、c_cpp_properties.json文件中includePath未加入include文件夹的头文件包含路径，将"${workspaceFolder}/include/**"追加入includePath中。
二、task.json文件中，未将include文件夹链接入编译，同时需将引用的头文件的源文件即cpp文件一起加入编译，即在args中加入如下两句：

				"-I","${workspaceFolder}/include",
				"${workspaceFolder}/lib/click.cpp",

追加后的task.json

{
	"version": "2.0.0",
	"tasks": [
		{
			"type": "cppbuild",
			"label": "C/C++: g++.exe 生成活动文件",
			"command": "G:/Tools/Compiler/MSYS2/msys64installtion/mingw64/bin/g++.exe",
			"args": [
				"-g",
				"${file}",
				"-fexec-charset=GBK",   // 处理mingw中文编码问题
                "-finput-charset=UTF-8",// 处理mingw中文编码问题，没有这俩中文显示会乱码
				"-I","${workspaceFolder}/include",
				"${workspaceFolder}/lib/click.cpp",
				"-o",
				"${fileDirname}\\${fileBasenameNoExtension}.exe"
			],
			"options": {
				"cwd": "G:/Tools/Compiler/MSYS2/msys64installtion/mingw64/bin"
			},
			"problemMatcher": [
				"$gcc"
			],
			"group": {
				"kind": "build",
				"isDefault": true
			},
			"detail": "编译器: G:/Tools/Compiler/MSYS2/msys64installtion/mingw64/bin/g++.exe"
		}
	]
}