Visual Studio Code 的 C/C++ 开发

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

C++ language features

安装扩展

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

C/C++ extension

设置您的 C++ 环境

C++ 是一种编译型语言,这意味着您的程序源代码在计算机上运行之前必须经过转换(编译)。C/C++ 扩展本身不包含 C++ 编译器或调试器,因为作为编辑器的 VS Code 依赖于命令行工具来进行开发工作流。您需要安装这些工具,或使用计算机上已有的工具。

检查是否安装了编译器

注意:您的学术或工作开发环境可能已经提供了 C++ 编译器和调试器。请向您的讲师或同事咨询,获取有关安装推荐 C++ 工具集(编译器、调试器、项目系统、代码检查器)的指导。

某些平台上预装的常用编译器包括 Linux 上的 GNU 编译器集合 (GCC),以及 macOS 上随 Xcode 提供的 Clang 工具。

检查您是否已安装这些工具:

  1. 使用以下快捷键打开新的 VS Code 终端窗口(⌃⇧` (Windows, Linux Ctrl+Shift+`)

  2. 使用以下命令检查 GCC 编译器 g++

    g++ --version
    

    或者使用以下命令检查 Clang 编译器 clang

    clang --version
    

输出应显示编译器版本及详细信息。如果两者均未找到,请确保您的编译器可执行文件已添加到平台的 PATH 环境变量中(Windows 上为 %PATH,Linux 和 macOS 上为 $PATH),以便 C/C++ 扩展能够找到它。否则,请按照下方的说明安装编译器。

安装编译器

如果您没有安装编译器,可以按照我们的安装教程进行操作:

Windows:

前往 MSVC 教程

前往 MinGW 教程

Linux:

前往 GCC 教程

macOS:

前往 Clang 教程

注意:如果您更倾向于使用内置编译、调试和项目模板(文件 > 新建项目)的完整集成开发环境 (IDE),也有许多可供选择的方案,例如 Visual Studio Community 版。

示例:在 Windows 上安装 MinGW-x64

为了理解整个过程,让我们通过 MSYS2 安装 Mingw-w64。Mingw-w64 是 Windows 上常用且免费的工具集,它提供了最新的 GCC、Mingw-w64 原生版本以及其他实用的 C++ 工具和库。

  1. 通过 此直接链接下载 MinGW 安装程序

  2. 运行安装程序并按照安装向导的步骤操作。请注意,MSYS2 需要 64 位 Windows 8.1 或更新版本。

  3. 在向导中,选择所需的安装文件夹。记录该目录以备后用。大多数情况下,建议的默认目录即可。设置开始菜单快捷方式的步骤也是如此。完成后,确保勾选 Run MSYS2 now 复选框并选择 Finish。随后将自动打开一个 MSYS2 终端窗口。

  4. 在此终端中,通过运行以下命令安装 MinGW-w64 工具链:

    pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain
    
  5. 将显示可用软件包列表:

    MYSS2 Installer

  6. Enter 键接受 toolchain 组中的默认软件包数量。

  7. 当提示是否继续安装时,输入 Y

  8. 使用以下步骤将 MinGW-w64 的 bin 文件夹路径添加到 Windows 的 PATH 环境变量中:

    1. 在 Windows 搜索栏中,输入 Settings(设置)以打开 Windows 设置。
    2. 搜索 Edit environment variables for your account(编辑账户的环境变量)。
    3. User variables(用户变量)中,选择 Path 变量,然后选择 Edit(编辑)。
    4. 选择 New(新建),并将您在安装过程中记录的 MinGW-w64 目标文件夹路径添加到列表中。如果您选择了默认安装步骤,则路径为:C:\msys64\ucrt64\bin
    5. 选择 OK(确定),然后在 Environment Variables(环境变量)窗口中再次选择 OK 以更新 PATH 环境变量。您必须重新打开所有控制台窗口,以便更新后的 PATH 环境变量生效。
  9. 要检查 MinGW-w64 工具是否正确安装并可用,请打开一个的命令提示符并输入:

    gcc --version
    g++ --version
    gdb --version
    

    您应该会看到显示您已安装的 GCC、g++ 和 GDB 版本的输出。如果并非如此,请确保您的 PATH 条目与编译器工具所在的 Mingw-w64 二进制目录匹配,或者参考故障排除章节

创建 Hello World 应用程序

为了确保编译器安装和配置正确,让我们创建一个 Hello World C++ 程序。

创建 C++ 文件

  1. 在 Windows 上,启动 Windows 命令提示符(在 Windows 搜索栏中输入 Windows command prompt)。在 macOS 和 Linux 上,您可以在终端中输入这些命令。

  2. 运行以下命令。它们会创建一个名为 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(是的,我信任作者)来接受 工作区信任 对话框。

  3. 现在,使用文件资源管理器中的 New File(新建文件)按钮或 File(文件)> New File(新建文件)命令创建一个名为 helloworld.cpp 的新文件。

    File Explorer New File button

添加 Hello World 源代码

粘贴以下源代码

#include <iostream>

int main()
{
    std::cout << "Hello World" << std::endl;
}

现在按 ⌘S (Windows, Linux Ctrl+S) 保存文件。您还可以通过勾选主 File(文件)菜单中的 Auto Save(自动保存)来启用 自动保存,以自动保存文件更改。

运行 helloworld.cpp

  1. 确保您已打开 helloworld.cpp,使其成为编辑器中的活动文件。

  2. 单击编辑器右上角的播放按钮。

    Screenshot of helloworld.cpp and play button

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

    C++ debug configuration dropdown

    您仅在首次运行 helloworld.cpp 时才会被提示选择编译器。此编译器将成为您 tasks.json 文件中设置的“默认”编译器。

  4. 构建成功后,您应该会看到“Hello World”出现在集成 Terminal(终端)中。

    screenshot of program output

恭喜!您刚刚在 VS Code 中运行了您的第一个 C++ 程序!下一步是使用下一节中的教程,进一步了解 Microsoft C/C++ 扩展的语言功能,例如 IntelliSense、代码导航、构建配置和调试。

教程

通过针对您环境的教程开始 C++ 和 VS Code 的学习之旅

文档

您可以在 VS Code 网站的 C++ 章节下找到关于使用 Microsoft C/C++ 扩展的更多文档,其中包括以下文章:

C++ TOC on code.visualstudio.com

远程开发

VS Code 和 C++ 扩展支持 远程开发,允许您通过 SSH 在远程机器或虚拟机上、在 Docker 容器内或在 Windows Linux 子系统 (WSL) 中进行工作。

要安装远程开发支持:

  1. 安装 VS Code 远程开发扩展包 (Remote Development Extension Pack)
  2. 如果远程源文件托管在 WSL 中,请使用 WSL 扩展。
  3. 如果您正在通过 SSH 连接到远程机器,请使用 Remote - SSH 扩展。
  4. 如果远程源文件托管在容器中(例如 Docker),请使用 Dev Containers 扩展。

使用 AI 增强补全

GitHub Copilot 是一款由 AI 驱动的代码补全工具,可以帮助你更快、更智能地编写代码。你可以在 VS Code 中使用 GitHub Copilot 扩展来生成代码,或从其生成的代码中学习。

GitHub Copilot extension in the VS Code Marketplace

GitHub Copilot 为多种语言和各种框架提供建议,在 Python、JavaScript、TypeScript、Ruby、Go、C# 和 C++ 方面表现尤为出色。

你可以在Copilot 文档中了解更多关于如何开始使用 Copilot 的信息。

反馈

如果您遇到任何问题或对 Microsoft C/C++ 扩展有任何建议,请在 GitHub 上提交问题和建议。如果您尚未提供反馈,也可以填写此 简短调查问卷

© . This site is unofficial and not affiliated with Microsoft.