🚀 在 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 指令，它将不会显示源文件主体的代码检查信息。如果您查看 VS Code 中的问题窗口，扩展将提供有关它无法定位哪些文件的更多信息。如果您仍然想显示代码检查信息，您可以更改 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 入门。

如何在适用于 Linux 的 Windows 子系统上使用新的 IntelliSense？

请参阅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 设置，并为IntelliSense 缓存路径添加用户设置。

"C_Cpp.intelliSenseCacheSize": <number>

此设置允许您设置扩展执行的缓存量的限制。这是一个近似值，但扩展将尽最大努力使缓存大小尽可能接近您设置的限制。如果您如上所述跨工作区共享缓存位置，您仍然可以增加/减少限制，但您应确保为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++ 扩展日志。

1/17/2023