当前位置：首页 > news >正文

MacOS 环境下 VSCode 的 C++ 环境搭建

news 2025/10/31 13:50:56

MacOS 环境下 VSCode 的 C++ 环境搭建

编译器安装

编译器可以选择 Clang 或者 GCC，在 MacOS 上 Clang 的安装更为简单一些。

Clang(推荐)

打开终端输入命令，

clang -v
查看是否已经安装。

如果已经安装，会输出类似于如下的信息：

Apple clang version 14.0.0 (clang-1400.0.29.202) Target: arm64-apple-darwin22.2.0 Thread model: posix InstalledDir: /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin

如果没有安装，则输入命令Xcode-select --install进行安装。

GCC

首先需要安装 brew，安装方法见官网，如果国内访问速度比较慢，可以自行搜索 brew 国内镜像。

然后输入命令brew install gcc进行安装。

插件安装

在 VSCode 中安装如下的三个插件

C/C++：提供了编辑的代码智能提示(IntelliSense)和调试(debugging) 功能；
CodeLLDB：提供了更加强力的调试支持；
Code Runner：更方便地运行代码（非调试）；
配置文件生成

c_cpp_properties.json

c_cpp_properties.json 中包含了编译器路径、头文件路径等等的设置信息，这些信息主要用于编辑的代码智能提示(IntelliSense)。

在 VSCode 中按下 ⇧⌘P，输入命令C/C++: Edit Configurations (UI)打开 C/C++ 的配置页面。根据 CPU 架构(一般是 Intel 或 Apple Silicon) 和编译器(Clang 或 GCC) 的不同，我们需要在配置页面中设置 编译器路径 和 IntelliSense 模式 这两个选项。

编译器路径

从下拉框中选择 Clang/GCC 可执行文件对应的路径。

Clang 的路径示例

/usr/bin/clang 或者 /usr/bin/clang++

GCC 的路径示例

/opt/homebrew/Cellar/gcc/12.2.0/bin/g++

IntelliSense 模式

CPU – 编译器 – 选项
Intel – Clang – macos-clang-x64
Intel – GCC – macos-gcc-x64
Apple Silicon – Clang – macos-clang-arm64
Apple Silicon – GCC – macos-gcc-arm64

在 C/C++ 的配置页面设置好之后，VSCode 会为我们自动生成c_cpp_properties.json 文件。

c_cpp_properties.json 的示例

{"configurations": [{"name": "Mac","includePath": ["${workspaceFolder}/**"],"defines": [],"macFrameworkPath": ["/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks"],"compilerPath": "/usr/bin/clang","cStandard": "c17","cppStandard": "c++17","intelliSenseMode": "macos-clang-arm64"}],"version": 4
}

tasks.json

在 tasks.json 中，我们会定义一个编译可执行文件的任务，

我们可以通过 VSCode 来自动生成这个文件，只要在 C++ 源文件中按下 F5，选择对应的选项（Clang 选择编译器 Clang++，GCC 选择编译器 G++），就会生成这个文件。

tasks.json 的示例

{"version": "2.0.0","tasks": [{"type": "cppbuild","label": "生成活动文件","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": "编译器: /usr/bin/clang++"}]
}

launch.json

在 launch.json 中我们将设置调试相关的内容。

在之前生成 tasks.json 的同时，也会自动生成这个文件。这个文件的 type 一般会设置为 cppdbg。为了使用 CodeLLDB，建议将其改成 lldb

launch.json 的示例(cppdbg)

{"version": "0.2.0","configurations": [{"name": "生成和调试活动文件","type": "cppdbg","request": "launch","program": "${fileDirname}/${fileBasenameNoExtension}","args": [],"stopAtEntry": true,"cwd": "${workspaceFolder}","environment": [],"externalConsole": true, // 推荐设置为 true，否则在调试过程中无法接受输入"MIMode": "lldb","preLaunchTask": "生成活动文件"}]
}

launch.json 的示例(lldb)

{"version": "0.2.0","configurations": [{"name": "生成和调试活动文件","type": "lldb","request": "launch","program": "${fileDirname}/${fileBasenameNoExtension}","args": [],"cwd": "${workspaceFolder}","preLaunchTask": "生成活动文件"}]
}

⚠️注意：请确保launch.json 中 preLaunchTask 的值和 tasks.json 中的 label 保持一致。