现已发布!阅读有关 11 月份新功能和修复的更多信息。

配置 C/C++ IntelliSense

本文介绍如何配置 C/C++ 扩展,以在 Visual Studio Code 中提供 C++ 特定的 IntelliSense 建议。IntelliSense 是 VS Code 中内置的实用工具,它提供了各种代码编辑功能,可帮助您更快、更高效地编写代码。例如,代码补全、参数信息、语法突出显示、代码操作(灯泡)和成员列表都是使用 IntelliSense 生成的。

C/C++ IntelliSense 仅需要在您的系统上安装 C/C++ 编译器。C/C++ 编译器向 IntelliSense 提供 C++ 特定信息,例如系统包含路径和其他设置的位置。有关项目级配置,请参考 项目级 IntelliSense 配置 部分。

C/C++ 扩展何时为我配置核心 IntelliSense 功能?

编译器是配置核心 IntelliSense 功能的唯一要求。为了标识用于 IntelliSense 的编译器,C/C++ 扩展会扫描您计算机上的常见路径以查找编译器,例如 Clang、GCC、MinGW、cygwin、cygwin64 和 MSVC。如果标识出任何这些编译器并且它们位于安全位置,则会自动为 IntelliSense 配置它们。否则,会显示一条通知,要求您确认应为 IntelliSense 配置此编译器。在这些情况下,选择的编译器也会被设置为默认编译器。

如何检查是否配置了 IntelliSense

如果未配置 IntelliSense,C/C++ 扩展会在状态栏中显示一个带有警告标志的黄色指示符,标签为配置 IntelliSense

Configure IntelliSense indicator in the status bar

要进行配置,请选择状态栏指示符,这将调出配置快速选择。快速选择可以帮助您选择或安装 C/C++ 编译器。

如果您没有看到状态栏指示符,您还可以检查项目的 c_cpp_properties.json 文件。此文件存储您的所有 IntelliSense 配置设置。通过从命令面板(⇧⌘P (Windows、Linux Ctrl+Shift+P))中选择C/C++: 编辑配置(UI)来导航到此文件。检查 IntelliSense 模式以查找您的配置。要了解有关 c_cpp_properties.json 文件的更多信息,您可以查看架构参考

Command Palette filtered on C/C++ Edit Configurations command

如何配置 IntelliSense

IntelliSense 配置存储在 c_cpp_properties.json 文件中,该文件会在您的工作区中自动创建。以下三种选项都是编辑 c_cpp_properties.json 文件的不同方式

选项 1. 通过配置快速选择选择配置选项

通过在命令面板中输入选择 IntelliSense 配置打开快速选择(⇧⌘P (Windows、Linux Ctrl+Shift+P)),这将显示一个下拉列表,其中包含 C/C++ 扩展在您的计算机上找到的所有配置选项。

Select a compiler to configure for IntelliSense Quick Pick

选择一个可用的选项。如果选择编译器,则默认情况下 IntelliSense 会使用此编译器。您可以随时返回到配置 IntelliSense 快速选择,以更改用于配置 IntelliSense 的选项。

如果快速选择中没有可用选项,则无法在您的系统中识别出编译器。您可以手动浏览您的计算机或安装 C/C++ 编译器。要在 Windows 计算机上安装,请选择帮助我安装编译器选项,该选项会将您重定向到有关如何安装 C/C++ 编译器的分步演练。在 macOS 或 Linux 计算机上,选择安装编译器并按照提示进行操作,以在您的计算机上安装 C++ 编译器。

选项 2. 通过 UI 编辑您的 IntelliSense 配置

通过从命令面板(⇧⌘P (Windows、Linux Ctrl+Shift+P))中选择C/C++:编辑配置(UI)来打开您的 IntelliSense 配置。此视图是 c_cpp_properties.json 文件的用户界面。

C/C++ IntelliSense Configurations user interface

编译器路径字段设置为您用于构建项目的编译器的完整路径。例如,在 Linux 上使用 GCC 的默认安装路径时,编译器路径为 /usr/bin/gcc。将IntelliSense 模式设置为您正在使用的编译器的特定于体系结构的变体。

选项 3. 直接编辑 c_cpp_properties.json 文件

您可以直接编辑 c_cpp_properties.json 文件以自定义您的配置。使用命令面板中的 C/C++ 编辑配置(JSON) 命令(⇧⌘P (Windows、Linux Ctrl+Shift+P)),然后将在工作区的 .vscode 文件夹中创建 c_cpp_properties.json 文件。

Command Palette filtered on C/C++ Edit Configurations (JSON) command

使用 compilerPath 变量添加编译器。此变量是您用于构建项目的编译器的完整路径。例如,在 Linux 上使用 GCC 的默认安装路径时,编译器路径为 /usr/bin/gcc

有关 c_cpp_properties.json 文件的更多信息,请查看架构参考

根据您的操作系统选择以下示例,了解 c_cpp_configuration.json 文件

> Windows 上的 c_cpp_configuration.json 示例

使用 MinGW 的默认安装路径

{
  "configurations": [
    {
      "name": "Win32",
      "includePath": ["${workspaceFolder}/**"],
      "defines": ["_DEBUG", "UNICODE", "_UNICODE"],
      "windowsSdkVersion": "10.0.22621.0",
      "cStandard": "c17",
      "cppStandard": "c++17",
      "intelliSenseMode": "${default}",
      "compilerPath": "C:/msys64/mingw64/bin/gcc.exe"
    }
  ],
  "version": 4
}

> macOS 上的 c_cpp_configuration.json 示例
使用 Clang 的默认安装路径
{
  "configurations": [
    {
      "name": "Mac",
      "includePath": ["${workspaceFolder}/**"],
      "defines": [],
      "macFrameworkPath": [
        "/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks"
      ],
      "compilerPath": "/usr/bin/clang",
      "cStandard": "c17",
      "cppStandard": "c++17",
      "intelliSenseMode": "macos-clang-arm64"
    }
  ],
  "version": 4
}

> Linux 上的 c_cpp_configuration.json 示例
使用 GCC 的默认安装路径
{
  "configurations": [
    {
      "name": "Linux-GCC",
      "includePath": ["${workspaceFolder}/**"],
      "defines": [],
      "compilerPath": "/usr/bin/g++",
      "cStandard": "c17",
      "cppStandard": "c++17",
      "intelliSenseMode": "gcc-x64",
      "browse": {
        "path": ["${workspaceFolder}"],
        "limitSymbolsToIncludedHeaders": true,
        "databaseFilename": ""
      }
    }
  ],
  "version": 4
}

项目级 IntelliSense 配置

使用编译器配置 IntelliSense 可为您提供核心 IntelliSense 功能。此设置称为基本配置。对于更复杂的使用方案,例如设置一个需要以下内容的项目

  • 其他包含路径,例如对一个或多个不同库的引用
  • 影响语言行为(因此也影响 IntelliSense)的特定编译器参数

还有多种其他方法可以配置 IntelliSense。您可以通过以下方式提供这些附加配置

  • c_cpp_properties.json 文件和相关设置
  • 另一种 VS Code 扩展形式的自定义配置提供程序(例如,Makefile 工具CMake 工具扩展)
  • compile_commands.json 文件

配置提供程序

自定义配置提供程序是 VS Code 中的另一个扩展,它可能提供比 C/C++ 扩展更准确的 C++ IntelliSense 配置。例如,对于 CMake 或 Make 构建系统,其中 Makefile 工具CMake 工具扩展可以是配置提供程序。要将扩展添加为配置提供程序,请通过配置快速选择选择扩展,通过编辑高级设置下的配置提供程序字段将其添加到配置 UI,或者将 configurationProvider 字段添加到您的 c_cpp_properties.json 文件。例如,对于 CMake 扩展,要添加的路径为 ms-vscode.cmake-tools

C/C++ Advanced Settings Configuration provider

C/C++ 扩展会扫描您的系统以查找自定义配置提供程序。如果它只识别出一个自定义配置提供程序,则会自动为 IntelliSense 配置此配置提供程序。如果识别出多个配置提供程序,您需要通过打开配置快速选择来选择扩展应使用的提供程序。

compile_commands.json 文件

提供 IntelliSense 配置的另一种选择是 compile_commands.json 文件,该文件描述了项目中每个文件使用的确切编译命令。此文件通常由构建系统(例如 CMake 或 Bazel)通过在配置项目时设置命令行参数来生成。可以通过与如何配置 IntelliSense部分中讨论的相同方法选择 compile_commands.json 文件进行配置,即通过配置快速选择、通过 UI 编辑配置或直接编辑 c_cpp_properties.json 文件。在配置 UI 中,该文件可以添加到高级配置编译命令字段下。例如,如果您的 compile_commands.json 文件位于工作区的根目录中,请在编译命令字段中输入 ${workspaceFolder}/compile_commands.json。否则,可以使用 compileCommands 配置属性直接将其添加到 c_cpp_properties.json 文件中。

如果编译命令数据库不包含与您在编辑器中打开的文件相对应的转换单元的条目,则将使用您的基本配置(在 c_cpp_properties.json 中找到),例如您的 includePathdefines。如果 C/C++ 扩展恢复为基本配置,则语言状态栏指示器会在状态栏中显示标签配置 IntelliSense

如果您指定了自定义配置提供程序和 compile_commands.json 文件,则首先查询自定义配置提供程序以获取 IntelliSense 配置。

如果您的程序包含不在您的工作区中或不在标准库路径中的头文件,您可以修改包含路径。C/C++ 扩展通过查询编译器路径指定的编译器来填充包含路径。如果扩展找不到目标系统库的路径,您可以手动输入包含路径。

使用语言状态栏检查 IntelliSense 活动

您可以使用语言状态栏确定 IntelliSense 是否在您的文件上积极工作。要调用语言状态栏,请打开一个 C++ 文件。状态栏显示文本 {} C++。将鼠标悬停在 {} 符号上以打开语言状态栏弹出窗口。弹出窗口中的顶部项指示 IntelliSense 状态。以下是不同的状态及其含义

  • IntelliSense:就绪 = IntelliSense 已为 C/C++ 扩展配置,并且如果您与编辑器交互(例如,通过编写代码),则会自动激活。
  • IntelliSense:正在更新 = IntelliSense 正在积极工作以根据您对代码所做的更改来确定任何代码补全、语法高亮等。

C++ extension language status bar flyout

您可以选择语言状态栏弹出窗口中任何项右侧的固定图标,以将其永久固定到您的状态栏。

后续步骤