VSCode插件报“找不到文件”90%因路径配置错误：调试需在子项目.launch.json中设"cwd"；search.exclude和files.exclude会隐藏文件；多根工作区各子项设置独立，须逐一核对。
VSCode 插件报“找不到文件”或“路径不存在”，90% 不是插件坏了，而是它压根没看到你认为它该读的那些路径——根源在工作目录、排除规则或配置作用域错位。
launch.json 里没配 cwd，调试时相对路径必然失效
VSCode 调试器默认继承窗口级工作目录，不是你当前编辑的文件所在目录。比如你在 src/main.c 里写 fopen("config.bin", "rb")，但窗口根目录是 /project，调试器却以 /home/user 为 cwd，自然打不开。
- 必须在
.vscode/launch.json的对应配置中显式设置"cwd": "${fileDirname}"（脚本自身目录）或"cwd": "${workspaceFolder}"（项目根目录） - 这个
launch.json必须放在子项目自己的.vscode/下，不能只放在工作区根目录的.vscode/里 - 别写
"cwd": "./backend"—— VSCode 不解析这种相对路径，会静默忽略 - Windows 上用
gdb.exe调试 C++ 时，miDebuggerPath也得是绝对路径，比如"C:/MinGW/bin/gdb.exe"
search.exclude 和 files.exclude 会彻底隐藏文件，不是搜索或加载失败
你 Ctrl+Shift+F 搜不到某段代码，大概率不是 VSCode 没扫到，而是它压根没读那个文件——因为被 search.exclude 过滤了；资源管理器空白，往往是因为 files.exclude 把整个子目录拦住了。
- 打开搜索面板右下角的 ! 图标，点掉「使用排除规则」，立刻能搜到？那就是它在拦
-
search.exclude中写"**/*.js": true或"src/**": true这类宽泛规则极易误伤，推荐用"**/node_modules/**": true -
files.exclude不仅影响资源管理器显示，某些扩展（如 WSL 插件）还会因此跳过监听 - Git 项目若启用了
"search.useIgnoreFiles": true，.gitignore里的路径也会被自动排除
c_cpp_properties.json 的 includePath 没对齐真实头文件位置
C/C++ 插件靠 c_cpp_properties.json 里的 includePath 找头文件。路径写错、漏写、或用了未展开的变量（比如 ${env:IDF_PATH} 但环境变量没生效），都会导致跳转失败、红色波浪线、补全失灵。
- 常见漏项：
"C:\Users\{user}\AppData\Local\Arm\Packs\Keil\STM32F1xx_DFP\2.4.1\Device\Include"（设备头文件）、"C:\Users\{user}\AppData\Local\Arm\Packs\ARM\CMSIS\5.9.0\CMSIS\Core\Include"（CMSIS 核心头文件） - Windows 下反斜杠不转义会直接解析失败，统一用正斜杠或双反斜杠
- ESP-IDF 项目需确保
compile_commands.json存在且完整，否则 CMake 插件无法把真实包含路径透传给 C/C++ 插件 - 不要依赖插件自动生成的配置，尤其多工作区环境下，手动校验
includePath是否覆盖所有idf.py build实际用到的路径
插件“消失”或不加载，本质是 VSCode 没读到 extensions 目录
插件列表为空 ≠ 插件被删了，而是 VSCode 启动时根本没扫描到 ~/.vscode/extensions（或 Windows 下的 %APPDATA%Codeextensions）——权限、路径重定向、沙箱限制都可能造成静默跳过。
- 运行
code --list-extensions，如果输出为空，说明当前进程没加载任何扩展 - 执行
code --show-versions，看顶部的User data directory路径是否和你预期一致；若用过--user-data-dir启动，插件实际装在那个自定义路径下 - Linux/macOS 下检查
ls -ld ~/.vscode和ls -la ~/.vscode/extensions，属主错成root或权限是drwx------都会导致读取失败 - Flatpak 版 VSCode 默认禁止访问
~/.vscode，需手动运行flatpak override --filesystem=~/.vscode com.visualstudio.code
最易被忽略的是：多根工作区中每个子文件夹的 .vscode/settings.json 独立生效，改错一个就可能让 C/C++ 插件拿不到正确的 includePath，而错误提示却只显示“无法解析包含路径”，不告诉你具体是哪个配置层出了问题。
