VSCode资源管理器不显示文件主因是配置或状态异常而非硬件问题：需依次排查files.exclude/search.exclude隐藏规则、是否正确Open Folder、远程连接状态、工作区范围、多根设置冲突、文件监视器崩溃（如inotify限制）、扩展干扰及Windows大小写敏感等。
VSCode 资源管理器不显示文件或文件夹
不是项目没打开，也不是磁盘坏了，而是 VSCode 的资源管理器（Explorer）本身没正确加载或同步文件系统状态。常见表现是：左侧文件树空白、刷新后仍无内容、Open Folder 后只显示根目录但子目录全空。
- 先检查是否误启用了
files.exclude或search.exclude，它们会**彻底隐藏匹配路径**，连资源管理器都不显示——哪怕文件真实存在。打开设置搜索files.exclude，清空或临时注释掉自定义规则 - 确认工作区是否处于「空文件夹」状态：点击菜单
File > Open Folder...，**必须选中一个含文件的物理目录**；仅靠File > New File创建的未保存文件不会出现在资源管理器中 - 如果用的是 WSL 或远程 SSH 扩展，资源管理器显示依赖远程文件系统挂载。执行
Remote-SSH: Kill VS Code Server on Host命令重启服务，再重连
“文件不存在”错误但路径明明正确
VSCode 报 Unable to open 'xxx': File not found.，而你在终端里 ls 或资源管理器里能看到它——这通常不是路径错，而是 VSCode 当前工作区上下文没覆盖该路径。
- 右键文件 →
Reveal in Explorer，看是否跳转到错误位置；若跳转失败，说明该文件不在当前打开的文件夹/工作区范围内 - 检查 VSCode 窗口标题栏右下角：显示的是当前工作区根路径。如果打开的是单个文件（没用
Open Folder），则所有相对路径解析都以该文件所在目录为基准，而非你期望的项目根目录 - 多根工作区（workspace）中，每个文件夹有独立的
.vscode/settings.json。某个子文件夹若配置了"files.watcherExclude": {"**/node_modules/**": true}，可能意外屏蔽了整个父级监听，导致新增文件不出现
资源管理器卡住、刷新图标一直转圈
这是文件监视器（file watcher）崩溃或被阻塞的典型信号，尤其在大仓库（如含 node_modules、dist、Git LFS 文件）中高频发生。
- 在命令面板（
Ctrl+Shift+P/Cmd+Shift+P）运行Developer: Toggle Developer Tools，切换到 Console 标签页，查找类似Watcher failed to initialize或ENOSPC错误——Linux/macOS 下通常是 inotify 限制不足 - Linux 用户执行：
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
；macOS 用户可尝试关闭Use Experimental Watcher设置（搜索该配置项并禁用） - 临时禁用所有扩展测试：启动时加参数
code --disable-extensions，若此时资源管理器恢复正常，逐个启用扩展定位问题插件（常见嫌疑：GitLens、Project Manager、某些文件索引类扩展）
Windows 上路径大小写敏感导致“找不到”
Windows 默认不区分大小写，但 VSCode 内部路径处理（尤其配合 Git、WSL 或某些语言服务器）可能触发严格匹配。例如磁盘上是 src/utils/Helper.ts，而你引用了 src/Utils/Helper.ts，资源管理器能显示，但跳转或类型检查会失败。
- 在资源管理器中右键目标文件夹 →
Copy Path，粘贴出来的真实路径就是 VSCode 认可的“正确大小写”版本 - 开启 VSCode 设置
files.enableTrash并设为false，可避免因回收站路径缓存导致的大小写混淆（尤其从回收站还原后） - 若使用 Git，确保
git config core.ignorecase返回true（Windows 默认值），否则git status和 VSCode 文件状态可能不一致，引发资源管理器显示延迟或遗漏
资源管理器的问题很少是单一原因，多数情况是配置叠加效应——比如 files.exclude + 远程连接 + 大文件夹监视失败同时发生。优先查设置、再看工作区范围、最后动系统级 watcher 配置。别直接重装 VSCode，90% 的 case 重启窗口或禁用扩展就能解决。
