本文介绍在苹果macOS操作系统下，配置Visual Studio Code的C/C++开发环境的过程，本环境使用Clang/LLVM 编译器和调试器。

一、前置条件

本文默认前置条件是，您的开发设备已经具备了如下软件：

1. 已经安装了微软Visual Studio Code macOS最新版；
2. 在VS Code中，安装了C++ 扩展插件。

安装方式：在VS Code中扩展搜索栏中，搜索'C++'，然后选择如下图所示的扩展你插件安装。

3. 确保本地 Clang编译器已经安装

在macOS终端中，输入：

clang --versionn

如果出现如下图所示的结果，表示你已安装过clang编译器：

如果没有出现上面的clang编译器版本显示，则使用如下命令安装clang:

xcode-select --install

二、创建一个测试应用

接下来我们创建一个测试应用项目，在macOS终端中，进入你的工作目录，输入如下命令创建应用目录：

mkdir helloworld
cd helloworld
code .

命令“code .”会使用VS Code打开你刚才创建的应用目录，并将该目录设置为当前工作空间。

如果提示命令code不存在（command not found: code），说明你安装完visual studio code后，没有设置path环境变量，通过如下方式设置：

1. 确保将Visual Studio Code应用程序安装到-Applications-文件夹中
2. 接下来，打开Visual Studio代码
   通过（P）打开命令面板，然后键入以找到Shell命令：shell command

执行命令后，重新启动终端以使新的$ 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.

在新建的文件中，输入如下C++代码：

#include <iostream>
#include <vector>
#include <string>

using namespace std;

int main()
{
    vector<string> msg {"Hello", "C++", "World", "from", "VS Code", "and the C++ extension!"};

    for (const string& word : msg)
    {
        cout << word << " ";
    }
    cout << endl;
}

按S 保存文件内容。

三、运行测试应用

接下来我们编译运行你 helloworld.cpp 这个文件。

1. 打开 helloworld.cpp ，注意：在VS Code中，编译、运行、调试，都是默认指的是当前打开的文件，也就是当前处于活动状态的tab中的文件。
2. 在当前打开的C文件tab界面的右上方，按运行按钮，在下拉菜单中选择“Debug C/C++ File”菜单，如下图。

3. 在弹出的编译器选择菜单中，选择“C/C++: clang++生成和调试活动文件”，（对应英文菜单显示 C/C++: clang++ build and debug active file ）如下图：

4. 执行完上面的步骤后，就会在你的工作目录下，生成.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++生成和调试活动文件”选项，如下图：

选择后，将在底部调试窗口调试运行当前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++扩展配置页面，如下图：

点击配置页面上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