参加你附近的 ,了解 VS Code 中的 AI 辅助开发。

常见问题

如何让 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

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

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

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

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

如何在 Windows 上使用 MinGW 让新的 IntelliSense 正常工作?

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

如何在 Windows Subsystem for Linux 上让新的 IntelliSense 正常工作?

请参阅 在 Visual Studio Code 中开始使用 C++ 和 Windows Subsystem for Linux

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

如果工作区文件夹通过带有符号链接的路径打开,文件可能会损坏(以及其他功能可能会失败)(问题 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": <字符串>

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

"C_Cpp.intelliSenseCacheSize": <数字>

此设置允许您限制扩展执行的缓存量。这是一个近似值,但扩展将尽力使缓存大小尽可能接近您设置的限制。如果您如上所述在工作区之间共享缓存位置,您仍然可以增加/减少限制,但您应该确保为 IntelliSense 缓存大小添加用户设置。

如何禁用 IntelliSense 缓存 (ipch)?

如果您不想使用 IntelliSense 缓存功能(例如,为了解决可能仅在启用缓存时发生的错误),您可以通过将 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 讨论中发起讨论,或者如果您发现需要修复的问题,请在 GitHub 问题中提出问题。

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

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