VSCode资源管理器不自动显示新建/删除的文件夹，因其采用快照机制而非实时监听，需手动刷新（F5或右键→“刷新”）；外部修改文件系统后不会主动感知，这是设计使然而非bug。
为什么VSCode资源管理器不自动显示新建/删除的文件夹
VSCode资源管理器本质是快照视图，不是实时监听器。它只在启动、手动刷新（F5 / 右键→“刷新”）或保存文件时重读磁盘状态。外部工具（如mkdir、git checkout、脚本生成文件）修改文件系统后，VSCode不会主动感知——这不是bug，是设计使然。
常见误判场景：
- 用
touch utils.js创建文件 → 侧边栏没出现 → 实际是VSCode还没重新扫描目录 - 在终端
rm -rf src/components→ VSCode里仍显示该文件夹 → 因为缓存未更新 - WSL2中从Linux侧创建文件 → Windows版VSCode看不到 → inotify事件跨层丢失
最稳方案：右键父文件夹 → “刷新”。比等“自动”更可靠，也避免插件引入的兼容性问题。
files.useExperimentalFileWatcher开启后仍不生效？检查files.watcherExclude
启用files.useExperimentalFileWatcher只是第一步。VSCode默认会排除大量路径（如**/.git/**、**/node_modules/**），但如果项目结构特殊（比如源码在packages/my-lib/src，而构建产物在packages/my-lib/dist），且你希望监听dist变更，就得显式放开：
- 打开
settings.json，确认files.watcherExclude没过度过滤：例如"**/dist/**"会屏蔽所有dist目录，删掉或改写为"!**/packages/*/dist/**" - WSL/Docker环境特别注意：
files.watcherInclude若被设为["src/**"]，则README.md或根目录tsconfig.json变更也会被忽略 - 大工作区（>10k文件）下，监听可能延迟数秒，不是失效——可临时缩小
files.watcherInclude范围验证
想让VSCode“看到”命令行创建的目录？别依赖插件，用File: Refresh Explorer
很多插件（如File Watchers）试图调用VSCode内部刷新逻辑，但官方未开放稳定API。实际触发Refresh Explorer最直接的方式是命令面板：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入
File: Refresh Explorer并回车（部分版本需先启用该命令：在keybindings.json中绑定快捷键） - 也可用VSCode命令行接口（需VSCode已运行）：
code --reuse-window --folder-uri file:///path/to/project -r，但仅适用于重载整个工作区
注意：Reload Window会中断调试和未保存编辑，而Refresh Explorer只刷新文件树，不影响当前编辑状态。
插件开发中监听目录变动？用vscode.workspace.onDidChangeWorkspaceFolders而非fs.watch
如果你正在写VSCode插件，并希望响应用户添加/移除文件夹（比如多根工作区变更），必须用VSCode提供的事件，而不是自己fs.watch监听.code-workspace文件：
-
vscode.workspace.onDidChangeWorkspaceFolders会在用户通过File > Add Folder to Workspace或修改.code-workspace后立即触发 -
vscode.workspace.onDidChangeConfiguration适合监听settings.json里跟路径相关的配置变更（如files.exclude） - 自行
fs.watch挂载点路径（如${localWorkspaceFolder}）极易在Remote-SSH/Containers下失效——Docker bind mount不转发inotify事件，SSH SFTP无文件系统事件
真正需要监听文件内容变更的场景（如自动生成API文档），应走vscode.workspace.createFileSystemWatcher，它适配所有远程连接模式，且自动处理路径映射。
