VSCode 需手动配置外部工具链才能支持 C++ 开发。Windows 推荐 MinGW-w64 并加 PATH;macOS 安装 Xcode 命令行工具和 brew install cmake gdb;Linux 用 apt 安装 build-essential、gdb、cmake。
VSCode 本身不是 IDE,不自带 C++ 编译器和调试器,所谓“配置环境”本质是把 g++(或 clang++)、cmake、gdb(或 lldb)这些外部工具链接进来,并让 VSCode 知道怎么调用它们。没装对工具链,装再多插件也没用。
确认系统已安装可用的 C++ 工具链
这是最常卡住的一步。Windows 用户别只装 VSCode 就以为完事了——VSCode 插件 C/C++ 不提供编译器,它只负责语法提示和跳转。
- Windows:推荐直接安装 MinGW-w64(x86_64-14.2.0-release-posix-seh),安装时勾选
add to PATH;装完后终端运行g++ --version和gdb --version必须有输出 -
macOS:运行
xcode-select --install装命令行工具,再用brew install cmake gdb(注意:macOS 自带的lldb可直接用,但gdb需要手动签名) - Linux(Ubuntu/Debian):运行
sudo apt update && sudo apt install build-essential gdb cmake
VSCode 必装插件与关键配置项
插件装错或配置路径写死,会导致 launch.json 或 c_cpp_properties.json 一直报“无法找到 IntelliSense 配置”。
- 必须安装:
C/C++(Microsoft 官方,IDms-vscode.cpptools),它提供头文件索引、#include补全、F12跳转 - 可选但强烈建议:
CMake Tools(配合CMake项目),CodeLLDB(macOS/Linux 下比gdb更省心) - 关键配置:打开命令面板(
Ctrl+Shift+P),输入C/C++: Edit Configurations (UI),在Compiler path里填绝对路径,例如 Windows 上是C:\mingw64\bin\g++.exe,不能写g++—— 否则 IntelliSense 找不到标准库路径
跑通一个最简 main.cpp 的三步操作
别一上来就搞多文件、CMakeLists.txt。先验证编辑、编译、调试闭环是否成立。