介绍在 macOS 系统下配置 VSCode 进行 C/C++ 开发的完整流程。内容包括安装 Xcode Command Line Tools 或 Homebrew GCC，安装必要扩展，配置 c_cpp_properties.json、tasks.json 和 launch.json 文件以实现智能提示、编译和调试功能。此外还涵盖多文件项目配置、Makefile 使用及常见错误解决方案，帮助用户快速搭建稳定的开发环境。
作为程序员，一个顺手的开发环境至关重要。VSCode 作为轻量级但功能强大的代码编辑器，配合 GCC/G++ 编译器，能够在 Mac 上提供优秀的 C/C++ 开发体验。本文将详细介绍从零开始的完整配置过程。
打开终端，执行以下命令：
xcode-select --install
执行后会弹出安装对话框，点击'安装'即可。这个过程会安装 GCC、G++、Make 等基础开发工具。
：
gcc --version
g++ --version
如果你需要更新版本的 GCC，可以通过 Homebrew 安装：
# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 GCC
brew install gcc
注意：通过 Homebrew 安装的 GCC 命令可能带有版本号，如 gcc-13、g++-13。
打开 VSCode，按 Cmd+Shift+X 打开扩展商店，搜索并安装以下扩展：
建议的项目目录结构：
my_cpp_project/
├── src/ # 源代码目录
│ └── main.cpp
├── include/ # 头文件目录
├── .vscode/ # VSCode 配置目录
│ ├── tasks.json # 编译任务配置
│ ├── launch.json # 调试配置
│ └── c_cpp_properties.json # 智能提示配置
└── Makefile # 编译脚本（可选）
在项目根目录创建 .vscode/c_cpp_properties.json：
{
"configurations": [
{
"name": "Mac",
"includePath": ["${workspaceFolder}/**", "/usr/local/include", "/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include"],
"defines": [],
"macFrameworkPath": "/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks",
"compilerPath": "/usr/bin/gcc",
"cStandard": "c17",
"cppStandard": "c++17",
"intelliSenseMode": "macos-gcc-x64"
}
],
"version": 4
}
如果使用 Homebrew 的 GCC，修改 compilerPath：
"compilerPath": "/usr/local/bin/gcc-13"
创建 .vscode/tasks.json，这是编译配置的核心：
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "C/C++: g++ build active file",
"command": "/usr/bin/g++",
"args": ["-std=c++17", "-g", "${file}", "-o", "${fileDirname}/${fileBasenameNoExtension}", "-I", "${workspaceFolder}/include"],
"options": {"cwd": "${fileDirname}"},
"problemMatcher": ["$gcc"],
"group": {"kind": "build", "isDefault": true}
}
]
}
创建 .vscode/launch.json，配置调试环境：
{
"version": "0.2.0",
"configurations": [
{
"name": "C/C++: g++ build and debug active file",
"type": "cppdbg",
"request": "launch",
"program": "${fileDirname}/${fileBasenameNoExtension}",
"args": [],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"externalConsole": false,
"MIMode": "lldb",
"preLaunchTask": "C/C++: g++ build active file"
}
]
}
在 src/main.cpp 中创建测试代码：
#include <iostream>
using namespace std;
int main() {
cout << "🎉 恭喜！VSCode C++ 环境配置成功！" << endl;
cout << "Hello, VSCode with GCC on Mac!" << endl;
// 简单的计算测试
int a = 10, b = 20;
cout << a << " + " << b << " = " << a + b << endl;
return 0;
}
Cmd+Shift+B 或通过终端菜单选择'运行生成任务'F5 开始调试./main对于包含多个源文件的项目，修改 tasks.json：
{
"version": "2.0.0",
"tasks": [
{
"type": "shell",
"label": "build project",
"command": "g++",
"args": ["-std=c++17", "-g", "src/*.cpp", "-Iinclude", "-o", "bin/main"],
"options": {"cwd": "${workspaceFolder}"},
"group": {"kind": "build", "isDefault": true},
"problemMatcher": ["$gcc"]
}
]
}
创建 Makefile：
CXX = g++
CXXFLAGS = -std=c++17 -g -Wall
SRCDIR = src
INCDIR = include
SOURCES = $(wildcard $(SRCDIR)/*.cpp)
TARGET = bin/main
$(TARGET): $(SOURCES)
$(CXX) $(CXXFLAGS) -I$(INCDIR) $^ -o $@
clean:
rm -f $(TARGET)
.PHONY: clean
对应的 tasks.json：
{"label":"make build","type":"shell","command":"make","group":"build"}
问题：gcc: command not found
解决：
# 检查 GCC 是否安装
xcode-select --install
# 如果使用 Homebrew 的 GCC，创建符号链接
sudo ln -s /usr/local/bin/gcc-13 /usr/local/bin/gcc
sudo ln -s /usr/local/bin/g++-13 /usr/local/bin/g++
问题：Permission denied
解决：
chmod +x /usr/local/bin/gcc*
问题：fatal error: iostream: No such file or directory
解决：确保 c_cpp_properties.json 中的包含路径正确。
问题：调试时提示各种错误
解决：
-g 参数launch.json 中的 MIMode 设置为 lldb（Mac 默认调试器）在 keybindings.json 中添加自定义快捷键：
[{"key":"cmd+shift+b","command":"workbench.action.tasks.build"}]
安装 Clang-Format 扩展，并在设置中配置：
{"C_Cpp.clang_format_style":"{ BasedOnStyle: Google, IndentWidth: 4 }"}
通过本文的详细步骤，你应该已经成功在 Mac 上配置好了 VSCode 的 C/C++ 开发环境。这个配置不仅支持基本的编译调试，还能够应对复杂的多文件项目开发。
配置成功的标志：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online