VS Code C/C++(1696)报错无法打开源文件但转到定义正常如何解决

问题现象 #

源文件头部代码如下：

#pragma once
#include <winsock2.h>
#include "pluginterfaces/vst/ivstevents.h"

第三行头文件引用触发C/C++扩展报错：

Cannot open source file "pluginterfaces/vst/ivstevents.h" C/C++(1696)

存在矛盾表现：右键头文件名选择「转到定义」时，可以正常定位打开ivstevents.h文件。
已知条件：

• pluginterfaces文件夹是当前工作区根目录的直接子目录
• 已在c_cpp_properties.json中做如下includePath配置：

"includePath": [
"${workspaceFolder}/**"
],

需求为消除该报错，让IntelliSense正常识别对应头文件，且无需逐个修改头文件引用路径。

已验证无效的操作 #

• 重置IntelliSense缓存，无任何效果
• 将头文件引用改为当前源文件出发的完整相对路径#include "../../../pluginterfaces/vst/ivstevents.h"时IntelliSense可正常识别，但涉及库的头文件总量大，逐行修改无可行性

根本原因 #

c_cpp_properties.json中includePath配置的${workspaceFolder}/**递归通配符，只会将工作区根目录下的所有子目录加入头文件搜索路径，不会将工作区根目录本身加入搜索路径。
此时引用"pluginterfaces/vst/ivstevents.h"时，IntelliSense会在所有已配置的搜索路径下拼接相对路径查找文件，由于根目录不在搜索列表中，无法匹配到工作区根目录/pluginterfaces/vst/ivstevents.h这个路径，因此抛出找不到文件的错误。
而「转到定义」功能走的是VS Code全局文件索引逻辑，不依赖IntelliSense的includePath配置，因此可以正常定位到文件。

修复步骤 #

1. 打开c_cpp_properties.json，修改includePath配置，显式将工作区根目录加入搜索路径：

"includePath": [
"${workspaceFolder}",
"${workspaceFolder}/**"
],

2. 按Ctrl+Shift+P调出命令面板，执行C/C++: Reset IntelliSense Database命令，等待IntelliSense完成重新索引，报错即可消失。

内容的提问来源于stack exchange，提问作者wcroughan