常见问题
- 如何让 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
指令,则不会显示源文件主体的代码检查信息。如果你检查 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
设置为你的编译器的路径。
如何让新的 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/
(或 $HOME/.cache/vscode-cpptools/
如果未定义 XDG_CACHE_HOME
) 和 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++ 扩展日志记录。