Visual Studio Code 的 C/C++ 开发
Visual Studio Code 的 C/C++ 支持由 Microsoft C/C++ 扩展提供,旨在支持 Windows、Linux 和 macOS 上的跨平台 C 和 C++ 开发。当您创建 *.cpp 文件时,该扩展会添加语法高亮(着色)、智能补全和悬停提示(IntelliSense)以及错误检查等功能。

安装扩展
- 打开 VS Code。
- 选择活动栏上的“扩展”视图图标,或使用键盘快捷键(⇧⌘X (Windows, Linux Ctrl+Shift+X))。
- 搜索
'C++'。 - 选择 安装。

设置您的 C++ 环境
C++ 是一种编译型语言,这意味着您的程序源代码在计算机上运行之前必须经过转换(编译)。C/C++ 扩展本身不包含 C++ 编译器或调试器,因为作为编辑器的 VS Code 依赖于命令行工具来进行开发工作流。您需要安装这些工具,或使用计算机上已有的工具。
检查是否安装了编译器
注意:您的学术或工作开发环境可能已经提供了 C++ 编译器和调试器。请向您的讲师或同事咨询,获取有关安装推荐 C++ 工具集(编译器、调试器、项目系统、代码检查器)的指导。
某些平台上预装的常用编译器包括 Linux 上的 GNU 编译器集合 (GCC),以及 macOS 上随 Xcode 提供的 Clang 工具。
检查您是否已安装这些工具:
-
使用以下快捷键打开新的 VS Code 终端窗口(⌃⇧` (Windows, Linux Ctrl+Shift+`))
-
使用以下命令检查 GCC 编译器
g++:g++ --version或者使用以下命令检查 Clang 编译器
clang:clang --version
输出应显示编译器版本及详细信息。如果两者均未找到,请确保您的编译器可执行文件已添加到平台的 PATH 环境变量中(Windows 上为 %PATH,Linux 和 macOS 上为 $PATH),以便 C/C++ 扩展能够找到它。否则,请按照下方的说明安装编译器。
安装编译器
如果您没有安装编译器,可以按照我们的安装教程进行操作:
Windows:
Linux:
macOS:
注意:如果您更倾向于使用内置编译、调试和项目模板(文件 > 新建项目)的完整集成开发环境 (IDE),也有许多可供选择的方案,例如 Visual Studio Community 版。
示例:在 Windows 上安装 MinGW-x64
为了理解整个过程,让我们通过 MSYS2 安装 Mingw-w64。Mingw-w64 是 Windows 上常用且免费的工具集,它提供了最新的 GCC、Mingw-w64 原生版本以及其他实用的 C++ 工具和库。
-
运行安装程序并按照安装向导的步骤操作。请注意,MSYS2 需要 64 位 Windows 8.1 或更新版本。
-
在向导中,选择所需的安装文件夹。记录该目录以备后用。大多数情况下,建议的默认目录即可。设置开始菜单快捷方式的步骤也是如此。完成后,确保勾选 Run MSYS2 now 复选框并选择 Finish。随后将自动打开一个 MSYS2 终端窗口。
-
在此终端中,通过运行以下命令安装 MinGW-w64 工具链:
pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain -
将显示可用软件包列表:

-
按 Enter 键接受
toolchain组中的默认软件包数量。 -
当提示是否继续安装时,输入
Y。 -
使用以下步骤将 MinGW-w64 的
bin文件夹路径添加到 Windows 的PATH环境变量中:- 在 Windows 搜索栏中,输入 Settings(设置)以打开 Windows 设置。
- 搜索 Edit environment variables for your account(编辑账户的环境变量)。
- 在 User variables(用户变量)中,选择
Path变量,然后选择 Edit(编辑)。 - 选择 New(新建),并将您在安装过程中记录的 MinGW-w64 目标文件夹路径添加到列表中。如果您选择了默认安装步骤,则路径为:
C:\msys64\ucrt64\bin。 - 选择 OK(确定),然后在 Environment Variables(环境变量)窗口中再次选择 OK 以更新
PATH环境变量。您必须重新打开所有控制台窗口,以便更新后的PATH环境变量生效。
-
要检查 MinGW-w64 工具是否正确安装并可用,请打开一个新的命令提示符并输入:
gcc --version g++ --version gdb --version您应该会看到显示您已安装的 GCC、g++ 和 GDB 版本的输出。如果并非如此,请确保您的 PATH 条目与编译器工具所在的 Mingw-w64 二进制目录匹配,或者参考故障排除章节。
创建 Hello World 应用程序
为了确保编译器安装和配置正确,让我们创建一个 Hello World C++ 程序。
创建 C++ 文件
-
在 Windows 上,启动 Windows 命令提示符(在 Windows 搜索栏中输入 Windows command prompt)。在 macOS 和 Linux 上,您可以在终端中输入这些命令。
-
运行以下命令。它们会创建一个名为
projects的空文件夹,您可以在其中放置所有的 VS Code 项目。接下来的命令将创建并进入名为helloworld的子文件夹。随后,通过code命令直接在 VS Code 中打开helloworld文件夹。mkdir projects cd projects mkdir helloworld cd helloworld code .“code .” 命令会在当前工作文件夹中打开 VS Code,该文件夹即成为您的“工作区”。由于这是您自己创建的文件夹,请通过选择 Yes, I trust the authors(是的,我信任作者)来接受 工作区信任 对话框。
-
现在,使用文件资源管理器中的 New File(新建文件)按钮或 File(文件)> New File(新建文件)命令创建一个名为
helloworld.cpp的新文件。
添加 Hello World 源代码
粘贴以下源代码
#include <iostream>
int main()
{
std::cout << "Hello World" << std::endl;
}
现在按 ⌘S (Windows, Linux Ctrl+S) 保存文件。您还可以通过勾选主 File(文件)菜单中的 Auto Save(自动保存)来启用 自动保存,以自动保存文件更改。
运行 helloworld.cpp
-
确保您已打开
helloworld.cpp,使其成为编辑器中的活动文件。 -
单击编辑器右上角的播放按钮。

-
从系统检测到的编译器列表中选择 C/C++: g++.exe build and debug active file。

您仅在首次运行
helloworld.cpp时才会被提示选择编译器。此编译器将成为您tasks.json文件中设置的“默认”编译器。 -
构建成功后,您应该会看到“Hello World”出现在集成 Terminal(终端)中。

恭喜!您刚刚在 VS Code 中运行了您的第一个 C++ 程序!下一步是使用下一节中的教程,进一步了解 Microsoft C/C++ 扩展的语言功能,例如 IntelliSense、代码导航、构建配置和调试。
教程
通过针对您环境的教程开始 C++ 和 VS Code 的学习之旅
- 通过 MinGW 在 Windows 上使用 GCC
- Windows 上的 Microsoft C++
- Linux 上的 GCC
- 在 Windows Linux 子系统上使用 GCC
- 在 macOS 上使用 Clang/LLVM
- Linux 上的 CMake 工具
文档
您可以在 VS Code 网站的 C++ 章节下找到关于使用 Microsoft C/C++ 扩展的更多文档,其中包括以下文章:

远程开发
VS Code 和 C++ 扩展支持 远程开发,允许您通过 SSH 在远程机器或虚拟机上、在 Docker 容器内或在 Windows Linux 子系统 (WSL) 中进行工作。
要安装远程开发支持:
- 安装 VS Code 远程开发扩展包 (Remote Development Extension Pack)。
- 如果远程源文件托管在 WSL 中,请使用 WSL 扩展。
- 如果您正在通过 SSH 连接到远程机器,请使用 Remote - SSH 扩展。
- 如果远程源文件托管在容器中(例如 Docker),请使用 Dev Containers 扩展。
使用 AI 增强补全
GitHub Copilot 是一款由 AI 驱动的代码补全工具,可以帮助你更快、更智能地编写代码。你可以在 VS Code 中使用 GitHub Copilot 扩展来生成代码,或从其生成的代码中学习。
GitHub Copilot 为多种语言和各种框架提供建议,在 Python、JavaScript、TypeScript、Ruby、Go、C# 和 C++ 方面表现尤为出色。
你可以在Copilot 文档中了解更多关于如何开始使用 Copilot 的信息。
反馈
如果您遇到任何问题或对 Microsoft C/C++ 扩展有任何建议,请在 GitHub 上提交问题和建议。如果您尚未提供反馈,也可以填写此 简短调查问卷。
