VSCode includePath报错：无法打开源文件"KS/dg.hpp"求助

项目目录结构：

.
├── KS
│   ├── include
│   │   ├── dg.hpp
│   │   ├── KS -> .
│   │   ├── node1.hpp
│   ├── makefile
│   └── src
│       ├── dg.cpp
│       ├── node1.cpp
├── main.cpp
├── makefile

打开KS/src/dg.cpp时，#include "KS/dg.hpp"行出现报错：无法打开源文件"KS/dg.hpp"（C/C++(1696)）。已在c_cpp_properties.json中配置includePath为"${workspaceFolder}/**"，通过Makefile编译正常，Alt+O可跳转文件，但VSCode始终显示该关联异常。

• 手动指定精确的包含路径
  尽管${workspaceFolder}/**会递归包含所有子目录，但VSCode的C/C++扩展对符号链接的解析可能存在优先级或延迟问题。在c_cpp_properties.json的includePath中添加更明确的路径：

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

  直接指定头文件所在的KS/include目录，绕开符号链接的解析障碍。

• 重载IntelliSense索引
  打开VSCode命令面板（Ctrl+Shift+P），执行C/C++: Reload IntelliSense，强制刷新扩展的索引缓存。有时索引未及时更新会导致错误提示残留。

• 验证符号链接有效性
  在终端执行ls -l KS/include/KS，确认该符号链接确实指向当前目录（.）。若链接失效，重新创建：

  cd KS/include
  ln -s . KS
  

  修复链接后再次执行IntelliSense重载。

• 调整包含语句写法
  既然KS/include已在包含路径中，可将#include "KS/dg.hpp"改为#include "dg.hpp"，既不影响编译（Makefile配置正确），又能直接消除VSCode的错误提示。若项目规范允许，这是最直接的方案。

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