尝试以扩展 VS Code 中的代理模式!

常见问题

如何让 IntelliSense 正常工作?

在没有任何配置的情况下,扩展将尝试通过搜索您的工作区文件夹和模拟在您计算机上找到的编译器来定位头文件。(例如,Windows 的 cl.exe/MinGW,macOS/Linux 的 gcc/clang)。如果这种自动配置不够,您可以通过运行 C/C++: 编辑配置 (UI) 命令来修改默认设置。在该视图中,您可以更改要模拟的编译器、要使用的包含文件路径、预处理器定义等。

或者,如果您安装了与我们的扩展接口的构建系统扩展,您可以允许该扩展为您提供配置。例如,CMake Tools 扩展可以配置使用 CMake 构建系统的项目。使用 C/C++: 更改配置提供程序... 命令来启用任何此类扩展为 IntelliSense 提供配置。

对于没有构建系统扩展支持的项目,第三个选项是使用 compile_commands.json 文件,如果您的构建系统支持生成此文件。在配置 UI 的“高级”部分,您可以提供 compile_commands.json 的路径,扩展将使用该文件中列出的编译信息来配置 IntelliSense。

注意:如果扩展无法解析源代码中的任何 #include 指令,它将不会显示源文件主体的 linting 信息。如果您检查 VS Code 中的问题窗口,扩展将提供有关它无法定位的文件的更多信息。如果您仍然希望显示 linting 信息,可以更改 C_Cpp.errorSquiggles 设置的值。

includePath 和 browse.path 有什么区别?

这两个设置在 c_cpp_properties.json 中可用,并且可能会令人困惑。

includePath

此路径字符串数组由“默认”IntelliSense 引擎使用,该引擎提供语义感知的 IntelliSense 功能。包含路径与您通过 -I 开关发送给编译器的路径相同。当解析您的源文件时,IntelliSense 引擎会将这些路径前置到您的 #include 指令指定的文件,同时尝试解析它们。除非以 /** 结尾,否则这些路径不会被递归搜索。

browse.path

此路径字符串数组由“Tag Parser”(“浏览引擎”)使用,该引擎用全局符号信息填充数据库。此引擎将递归地枚举指定路径下的所有文件,并在对您的项目文件夹进行标签解析时将它们作为潜在的包含文件进行跟踪。要禁用对路径的递归枚举,您可以在路径字符串后附加 /*

当您第一次打开工作区时,扩展会将 ${workspaceFolder}/** 添加到 includePath,并将 browse.path 留空(因此它默认为 includePath)。如果不希望这样,您可以打开您的 c_cpp_properties.json 文件并进行更改。

为什么标准库类型下会出现红色波浪线?

最常见的原因是缺少包含路径和定义。最简单的解决方法是在 c_cpp_properties.json 中将 compilerPath 设置为您的编译器路径。

如何让新的 IntelliSense 在 Windows 上与 MinGW 协同工作?

请参阅在 Visual Studio Code 中开始使用 C++ 和 Mingw-w64

如何让新的 IntelliSense 与适用于 Linux 的 Windows 子系统协同工作?

请参阅在 Visual Studio Code 中开始使用 C++ 和适用于 Linux 的 Windows 子系统

为什么我的文件在格式化时会损坏?

如果通过带有符号链接的路径打开工作区文件夹,文件可能会损坏(并且其他功能可能会失败)(问题 vscode-cpptools#5061)。解决方法是使用将符号链接解析为其目标的路径打开工作区文件夹。

如何重新创建 IntelliSense 数据库?

从扩展的 0.12.3 版本开始,有一个命令可以重置您的 IntelliSense 数据库。打开命令面板(⇧⌘P(Windows、Linux Ctrl+Shift+P)并选择 C/C++: 重置 IntelliSense 数据库命令。

什么是 ipch 文件夹?

语言服务器会缓存有关包含的头文件的信息,以提高 IntelliSense 的性能。当您在工作区文件夹中编辑 C/C++ 文件时,语言服务器会将缓存文件存储在 ipch 文件夹中。默认情况下,ipch 文件夹存储在用户目录下。具体来说,在 Windows 上存储在 %LocalAppData%/Microsoft/vscode-cpptools 下,在 Linux 上存储在 $XDG_CACHE_HOME/vscode-cpptools/ 下(如果 XDG_CACHE_HOME 未定义,则为 $HOME/.cache/vscode-cpptools/),在 macOS 上存储在 $HOME/Library/Caches/vscode-cpptools/ 下。通过使用用户目录作为默认路径,它将为扩展的每个用户创建一个缓存位置。由于缓存大小限制应用于一个缓存位置,因此每个用户一个缓存位置将把缓存的磁盘空间使用量限制在该一个文件夹中,适用于所有使用默认设置值的用户。

未使用 VS Code 的每个工作区存储文件夹,因为 VS Code 提供的该位置并不广为人知,我们不希望在用户可能看不到或不知道在哪里找到它们的地方写入 GB 级的文件。

考虑到这一点,我们知道我们无法满足每种不同开发环境的需求,因此我们提供了设置,允许您自定义最适合您情况的工作方式。

"C_Cpp.intelliSenseCachePath": <string>

此设置允许您为缓存路径设置工作区或全局覆盖。例如,如果您想为所有工作区文件夹共享一个缓存位置,请打开 VS Code 设置,并为智能感知缓存路径添加一个用户设置。

"C_Cpp.intelliSenseCacheSize": <number>

此设置允许您对扩展所做的缓存量设置限制。这是一个近似值,但扩展会尽力将缓存大小保持在您设置的限制附近。如果您像上面解释的那样在工作区之间共享缓存位置,您仍然可以增加/减少限制,但您应确保为智能感知缓存大小添加一个用户设置。

如何禁用 IntelliSense 缓存 (ipch)?

如果您不想使用 IntelliSense 缓存功能(例如为了解决可能仅在启用缓存时才出现的错误),您可以通过将智能感知缓存大小设置为 0(或在 JSON 设置编辑器中为 "C_Cpp.intelliSenseCacheSize": 0)来禁用该功能。如果您看到过多的磁盘写入,特别是在编辑头文件时,禁用缓存也可能是有益的。

如何设置调试?

调试器需要配置以知道使用哪个可执行文件和调试器

从主菜单中,选择运行 > 添加配置...

现在 launch.json 文件将打开以供编辑,并带有一个新配置。默认设置很可能会起作用,但您需要指定 program 设置。

有关如何配置调试器的更深入文档,请参阅配置 C/C++ 调试

如何启用调试符号?

启用调试符号取决于您使用的编译器类型。以下是一些编译器以及启用调试符号所需的编译器选项。

如有疑问,请查阅您的编译器文档,了解在输出中包含调试符号所需的选项。这可能是 -g--debug 的某种变体。

Clang (C++)

  • 如果您手动调用编译器,请添加 --debug 选项。
  • 如果您正在使用脚本,请确保设置了 CXXFLAGS 环境变量。例如,export CXXFLAGS="${CXXFLAGS} --debug"
  • 如果您正在使用 CMake,请确保设置了 CMAKE_CXX_FLAGS。例如,export CMAKE_CXX_FLAGS=${CXXFLAGS}

Clang (C)

参见 Clang C++,但使用 CFLAGS 代替 CXXFLAGS

gcc 或 g++

如果您手动调用编译器,请添加 -g 选项。

cl.exe

符号位于 *.pdb 文件中。

为什么调试不工作?

我的断点没有被命中

当您开始调试时,如果您的断点未绑定(实心红圈)或未被命中,您可能需要在编译期间启用调试符号

调试开始,但我堆栈跟踪中的所有行都是灰色的

如果您的调试器显示灰色的堆栈跟踪,不会在断点处停止,或者调用堆栈中的符号是灰色的,那么您的可执行文件是在没有调试符号的情况下编译的。

如果我怀疑 C/C++ 扩展有问题该怎么办

如果您有任何其他问题,请在 GitHub discussions 上发起讨论,或者如果您发现需要修复的问题,请在 GitHub issues 上提交问题。

如果您遇到了我们无法根据您问题报告中的信息诊断的扩展问题,我们可能会要求您启用调试日志记录并向我们发送您的日志。有关如何获取 C/C++ 扩展日志的信息,请参阅C/C++ 扩展日志记录