用VSCode开发C++项目
写在前面
最近在新学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"
}
]
}
- 切换到main.cpp,程序完美运行。如此,方能进行自定义头文件的引用。
六、附录(路径表示说明)
在vscode中定义了一些变量,在配置任务脚本时,可能会用到。本文以launch.json脚本为例,介绍各个变量的含义。
假设当前workspace的路径为:“C:\Users\admin\Desktop\test”,workspace文件夹下的结构如下(+表示下一层):
C:\Users\admin\Desktop\test
+.vscode
++tasks.json
++launch.json
+main.cpp
${workspaceFolder} :表示当前workspace文件夹路径,也即C:\Users\admin\Desktop\test
${workspaceRootFolderName}:表示workspace的文件夹名,也即test
${file}:文件自身的绝对路径,也即C:\Users\admin\Desktop\test.vscode\launch.json
${relativeFile}:文件在workspace中的路径,也即.vscode\launch.json
${fileBasenameNoExtension}:当前文件的文件名,不带后缀,也即launch
${fileBasename}:当前文件的文件名,launch.json
${fileDirname}:文件所在的文件夹路径,也即C:\Users\admin\Desktop\test.vscode
${fileExtname}:当前文件的后缀,也即.json
${lineNumber}:当前文件光标所在的行号
${env:PATH}:系统中的环境变量
参考:1、Visual Studio Code (vscode) 配置C、C++环境/编写运行C、C++(Windows)【真正的小白版】
2、使用vscode创建C++工程
3、Windows下用VScode编写C++程序如何添加并应用自定义头文件
4、VSCode launch.json中的各种替换变量的意思 ${workspaceFolder} ${file} ${fileBasename} ${fileDirname}等
5\VSCODE官方文档—在MinGW上使用GCC(Using GCC with MinGW)
更多推荐
所有评论(0)