本文介绍在苹果macOS操作系统下,配置Visual Studio Code的C/C++开发环境的过程,本环境使用Clang/LLVM 编译器和调试器。
一、前置条件
本文默认前置条件是,您的开发设备已经具备了如下软件:
- 已经安装了微软Visual Studio Code macOS最新版;
- 在VS Code中,安装了C++ 扩展插件。
安装方式:在VS Code中扩展搜索栏中,搜索'C++',然后选择如下图所示的扩展你插件安装。
在VS Code中安装C/C++扩展插件
- 确保本地 Clang编译器已经安装
在macOS终端中,输入:
clang --versionn
如果出现如下图所示的结果,表示你已安装过clang编译器:
clang编译器版本
如果没有出现上面的clang编译器版本显示,则使用如下命令安装clang:
xcode-select --install
二、创建一个测试应用
接下来我们创建一个测试应用项目,在macOS终端中,进入你的工作目录,输入如下命令创建应用目录:
mkdir helloworld
cd helloworld
code .
命令“code .”会使用VS Code打开你刚才创建的应用目录,并将该目录设置为当前工作空间。
如果提示命令code不存在(command not found: code),说明你安装完visual studio code后,没有设置path环境变量,通过如下方式设置:
- 确保将Visual Studio Code应用程序安装到-Applications-文件夹中
- 接下来,打开Visual Studio代码
通过(P)打开命令面板,然后键入以找到Shell命令:shell command
VS Code中,设置PATH环境变量
执行命令后,重新启动终端以使新的$ PATH值生效。
使用code . 命令打开当前工作目录后,下面将分别创建三个项目工程配置文件:
- tasks.json (编译器构建配置)
- launch.json (调试器配置)
- c_cpp_properties.json (编译路径和智能感知配置)
这三个配置文件都存放在工作目录的.vscode 目录下。
注意:.vscode在macOS和linux中是隐身文件夹,使用macOS Finder是看不到的,需要在终端中,使用ls -a命令才能看到,或者在VS Code的文件浏览窗口中能看到。
2.1、添加一个C++源代码文件
在VS Code的File Explorer 面板中,使用新建文件按钮,创建一个文件 helloworld.cpp.
在测试工程中,创建一个helloworld.cpp文件
在新建的文件中,输入如下C++代码:
#include
#include
#include
using namespace std;
int main()
{
vector msg {"Hello", "C++", "World", "from", "VS Code", "and the C++ extension!"};
for (const string& word : msg)
{
cout << word << " ";
}
cout << endl;
}
按S 保存文件内容。
三、运行测试应用
接下来我们编译运行你 helloworld.cpp 这个文件。
- 打开 helloworld.cpp ,注意:在VS Code中,编译、运行、调试,都是默认指的是当前打开的文件,也就是当前处于活动状态的tab中的文件。
- 在当前打开的C文件tab界面的右上方,按运行按钮,在下拉菜单中选择“Debug C/C++ File”菜单,如下图。
运行一个C++文件
- 在弹出的编译器选择菜单中,选择“C/C++: clang++生成和调试活动文件”,(对应英文菜单显示 C/C++: clang++ build and debug active file )如下图:
使用clang++编译器生成可执行文件
- 执行完上面的步骤后,就会在你的工作目录下,生成.vscode目录,在.vscode目录下自动生成了文件:tasks.json配置文件,内容格式如下:
{
"tasks": [
{
"type": "cppbuild",
"label": "C/C++: clang++ 生成活动文件",
"command": "/usr/bin/clang++",
"args": [
"-fcolor-diagnostics",
"-fansi-escape-codes",
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}"
],
"options": {
"cwd": "${fileDirname}"
},
"problemMatcher": [
"$gcc"
],
"group": {
"kind": "build",
"isDefault": true
},
"detail": "调试器生成的任务。"
}
],
"version": "2.0.0"
}
运行后,底部调试窗口会输出程序打印的内容。
四、配置调试按钮
如果你想使用F5键,或者VS Code左侧的“运行和调试”按钮,调试helloworld.cpp文件,可以通过如下方式创建和配置launch.json 文件。
在当前打开的helloworld.cpp文件的右上方,点击配置齿轮按钮,在弹出的顶部下拉框中,选择“C/C++: clang++生成和调试活动文件”选项,如下图:
创建launch.json文件
选择后,将在底部调试窗口调试运行当前C++文件,并在工程目录下的.vscode目录下,生成launch.json 配置文件,内容格式如下:
{
"configurations": [
{
"name": "C/C++: clang++ 生成和调试活动文件",
"type": "cppdbg",
"request": "launch",
"program": "${fileDirname}/${fileBasenameNoExtension}",
"args": [],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"externalConsole": false,
"MIMode": "lldb",
"preLaunchTask": "C/C++: clang++ 生成活动文件"
}
],
"version": "2.0.0"
}
配置了launch.json文件后,在当前打开的C++文件tab窗口中,按F5键,或者点击左侧的“运行和调试”按钮,就会使用launch.json文件中的配置,来调试运行当前打开的C++文件,如下图:
运行和调试文件
五、添加C/C++扩展配置文件
如果想进行更多的C/C++扩展插件的配置,需要在.vscode目录下创建一个 c_cpp_properties.json 文件。
按快捷键(P)打开搜索栏,输入“C/C++: Edit Configurations (UI)” ,
C/C++ UI配置
点击选中该选项,打开C/C++扩展配置页面,如下图:
C/C++扩展配置页面
点击配置页面上Mac输入框后面的“Add Configuration”(添加配置)按钮,生成
.vscode/c_cpp_properties.json. 文件,内容格式如下:
{
"configurations": [
{
"name": "Mac",
"includePath": [
"${workspaceFolder}/**"
],
"defines": [],
"macFrameworkPath": [
"/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks"
],
"compilerPath": "/usr/bin/clang",
"cStandard": "c17",
"cppStandard": "c++17",
"intelliSenseMode": "macos-clang-x64"
}
],
"version": 4
}
至此,macOS下,使用VS Code开发C/C++应用的项目工程配置所需要的三个主要配置文件,都创建完毕。
六、最后
关于三个配置文件的详细内容,以及更多VS Code C/C++配置内容,请参阅VS Code官方文档:
https://code.visualstudio.com/docs/cpp/config-clang-mac