探索智能体开发 -

常见问题

如何让 IntelliSense 正常工作？

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

或者，如果您安装了与我们的扩展程序交互的构建系统扩展程序，则可以让该扩展程序为您提供配置。例如，CMake Tools 扩展程序可以配置使用 CMake 构建系统的项目。使用 C/C++: Change Configuration Provider... 命令来启用任何此类扩展程序，以便为 IntelliSense 提供配置。

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

注意：如果扩展程序无法解析源代码中的任何 #include 指令，它将不会显示源文件主体的 Lint 信息。如果您查看 VS Code 中的问题 (Problems) 窗口，扩展程序将提供关于它无法定位哪些文件的更多信息。如果您仍然希望显示 Lint 信息，可以更改 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 设置为您的编译器路径。

如何让新的 IntelliSense 在 Windows 上与 MinGW 一起工作？

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

如何让新的 IntelliSense 在适用于 Linux 的 Windows 子系统 (WSL) 上工作？

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

为什么我的文件在格式化后损坏了？

如果通过包含符号链接的路径打开工作区文件夹，文件可能会损坏（并且其他功能可能会失败）（问题 vscode-cpptools#5061）。解决方法是使用符号链接已解析到其目标的路径来打开工作区文件夹。

如何重新创建 IntelliSense 数据库？

从扩展程序的 0.12.3 版本开始，有一个用于重置 IntelliSense 数据库的命令。打开命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 并选择 C/C++: Reset IntelliSense Database 命令。

什么是 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 Cache Path 添加用户设置。

"C_Cpp.intelliSenseCacheSize": <number>

此设置允许您设置扩展程序进行缓存的数量限制。这是一个近似值，但扩展程序将尽最大努力使缓存大小尽可能接近您设置的限制。如果您按照上述说明在工作区之间共享缓存位置，您仍然可以增加/减少限制，但应该确保为您添加 IntelliSense Cache Size 的用户设置。

如何禁用 IntelliSense 缓存 (ipch)？

如果您不想使用 IntelliSense 缓存功能（例如为了绕过可能仅在启用缓存时才会发生的错误），可以通过将 IntelliSense Cache Size 设置为 0（或在 JSON 设置编辑器中设置为 "C_Cpp.intelliSenseCacheSize": 0"）来禁用该功能。如果您发现磁盘写入过多（尤其是在编辑头文件时），禁用缓存也可能是有益的。

如何设置调试？

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

从主菜单中，选择 运行 (Run) > 添加配置... (Add Configuration...)。

文件 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++ 扩展日志。

1/17/2023
English 한국어 中文(简体) 中文(繁體)
© . This site is unofficial and not affiliated with Microsoft.