quick-folder

Instant file and folder search, with one-key reveal in the VS Code Explorer.

快速搜索工作区中的文件和目录，回车直接定位到 VS Code 资源管理器。

使用

1. 打开一个工作区，按 Ctrl+Shift+J（macOS：Cmd+Shift+J）。
2. 输入文件名、目录名、多个路径关键词，或者粘贴完整绝对路径。
3. 按回车，在资源管理器中定位选中项。

launcher.cpp
cli launch
/workspace/my-project/src/cli/launch/

搜索框立即显示，首次后台索引逐步补充结果。完整绝对路径可直接查找，无需等待全量索引完成。 搜索按完整路径执行不区分大小写的关键词包含匹配；多个关键词用空格分隔。 输入末尾的 / 或 \ 可将索引搜索限制为目录。

功能

• 同时查找文件与目录，匹配名称和完整路径。
• 后台并发扫描，无固定目录深度限制。
• 复用内存索引和磁盘缓存；缓存超过 5 分钟时后台重建。
• 文件或目录创建、删除后更新索引。
• 默认只向 UI 发送最多 200 个匹配项。
• 支持本地、Remote SSH 和 Dev Containers 的桌面工作区。
• 不自动打开文件、不关闭现有编辑器。

索引不递归遍历符号链接。搜索范围限于当前工作区；完整路径指扩展运行所在主机的路径， 因此在容器工作区中应输入容器路径。暂不支持浏览器版 VS Code 或虚拟工作区。

命令

如果外部文件变化未反映到搜索中，可运行刷新索引命令。 Quick Folder 输出通道包含索引耗时和读取统计。

设置

完整绝对路径可直接定位工作区内被后台索引排除的文件或目录。 默认排除 .git、node_modules、build、dist 等目录，可在设置中修改。

数据处理

扩展不包含网络请求或遥测，不读取文件内容来建立索引。索引包含本地路径，保存在 VS Code 为此扩展分配的 storage 目录中；远程工作区的缓存保存在远程扩展宿主上。

安装与开发

从 VSIX 安装：扩展面板菜单 → 从 VSIX 安装，选择包文件。 如果同时安装 Jump Folder，请禁用其 Ctrl+Shift+J 绑定，或在键盘快捷键中明确绑定 quick-folder.open。

npm ci --ignore-scripts
npm test
npm run package

运行时无第三方 npm 依赖。打包工具为官方 @vscode/vsce，构建环境需要 Node.js 22 或更新版本。

License

MIT。来源与致谢见 NOTICE.md。