VSCode怎么在全局搜索时排除打包生成的dist或build文件夹

用VSCode做全局搜索时,你是不是也经常被一堆打包生成的dist、build文件夹结果干扰?明明只想找源码,结果却淹没在编译后的文件里。别急,这事儿有解,而且方法不止一种。
全局搜索时用 filesToExclude 排除 dist 和 build
最一劳永逸的方法,就是配置search.exclude。这个设置项是专门为搜索过滤设计的,它只影响搜索结果,不会动你的文件资源管理器,也不会干扰调试等其他功能。
具体操作很简单,打开你的用户设置(Ctrl+, / Cmd+,)或工作区设置,加上这么一段:
{
"search.exclude": {
"**/dist": true,
"**/build": true,
"**/node_modules": true
}
}
- 这里的
**/dist和**/build是glob模式,意味着它能匹配项目任意层级下的同名文件夹。 - 值设为
true就是排除;如果想临时恢复搜索,设为false或者直接删掉这条配置就行。 - 如果你的项目构建输出目录不止这两个(比如还有
.next、out),照葫芦画瓢,一并加进去就好。
搜索时手动输入 -folder:dist 快速跳过
如果只是临时想排除一下,不想动配置文件,有没有更灵活的办法?当然有。直接在搜索框里用排除语法就行。
VSCode的搜索框支持-folder:这个限定符。比如你想搜索fetch这个关键词,但又不想看到dist和node_modules里的结果,就这么输入:
fetch -folder:dist -folder:node_modules
- 前面的
fetch是你要搜的关键词。 - 后面的
-folder:dist就表示:跳过所有名叫dist的文件夹,包括它里面的所有子路径。 - 这个语法可以组合使用,也支持
-file:来排除特定文件。 - 注意一个小细节:这里不能写成
-folder:**/dist。-folder:后面只跟文件夹名,不支持带通配符的路径模式。
为什么不用 files.exclude?
这里有个常见的“坑”需要特别提醒。很多人会想到用files.exclude来隐藏文件,以为这样搜索就找不到了。其实不然。
files.exclude只管一件事:控制左侧文件资源管理器的显示与否。被你“隐藏”的文件,在全局搜索时依然会被扫出来。- 真正控制搜索范围的,是前面提到的
search.exclude。这两个设置各司其职,不能互相替代。 - 如果你发现明明在
files.exclude里配了**/dist/**,但搜索时还是能搜到dist里的内容,那就是踩中这个误区了。记住,搜索过滤,请认准search.exclude。
多根工作区下要注意作用域优先级
如果你的项目是多文件夹工作区(使用了.code-workspace文件),配置生效的优先级顺序是:工作区设置 > 用户设置。这有时候会导致“明明配了却没用”的困惑。
- 首先,检查一下VSCode窗口右下角,看看是不是显示着“工作区”字样。如果是,那么你修改设置时,一定要确保是在“工作区”标签页里编辑的
search.exclude。 - 举个例子:你在用户设置里排除了
dist,但在工作区设置里又把它设成了false,那么最终生效的会是工作区的设置(即不排除)。 - 如果实在不确定最终生效的配置是什么,可以打开命令面板(
Ctrl+Shift+P/Cmd+Shift+P),运行Developer: Toggle Developer Tools,在开发者工具的Console里搜索search.exclude,就能看到VSCode最终计算合并后的配置值了。
说到底,真正起作用的,永远是VSCode根据当前工作区计算出来的那个最终的search.exclude对象,而不是你记忆中“应该配置过”的那一个。搞清楚这一点,配置起来就心里有底了。
