常见问题
- 如何让 IntelliSense 正常工作?
- c_cpp_properties.json 中 includePath 和 browse.path 有什么区别?
- 为什么标准库类型下会出现红色波浪线?
- 如何让新的 IntelliSense 在 Windows 上与 MinGW 配合使用?
- 如何让新的 IntelliSense 在适用于 Linux 的 Windows 子系统上工作?
- 为什么我的文件格式化后会损坏?
- 如何重新创建 IntelliSense 数据库?
- ipch 文件夹是什么?
- 如何禁用 IntelliSense 缓存 (ipch)?
- 如何设置调试?
- 如何启用调试符号?
- 为什么调试不起作用?
- 如果我怀疑 C/C++ 扩展有问题,该怎么办?
如何让 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
设置为您的编译器路径。
如何让新的 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 设置,并为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++ 扩展日志记录。