唯一真正生效的路径过滤方式是直接配置folder_exclude_patterns(屏蔽文件夹)和file_exclude_patterns(屏蔽文件),二者须写入项目或用户设置中,且需手动刷新侧边栏;folder_exclude_patterns匹配文件夹名(如"node_modules"),file_exclude_patterns匹配文件名(如"*.log"),分别控制侧边栏显示与搜索范围。

直接改 folder_exclude_patterns 和 file_exclude_patterns 就行,这是唯一真正生效的路径过滤方式。别指望右键菜单或拖拽能解决——Sublime 的侧边栏不支持“点击隐藏某类文件”这种交互。
folder_exclude_patterns 用来屏蔽整个文件夹
它匹配的是文件夹名(不是路径),不区分大小写,但不能带斜杠或点前缀。
- 正确写法:
"node_modules"、"__pycache__"、".git" - 错误写法:
"./node_modules"、"/node_modules"、"node_modules/"—— 这些全无效 - 它跳过整个目录扫描,性能更好,也更彻底;
.DS_Store这种隐藏文件夹必须放这里才管用(因为它是文件夹,不是文件) - 多个项目可为每个
"folders"对象单独配规则,互不影响
file_exclude_patterns 用来屏蔽特定后缀的文件
它匹配文件名(含后缀),支持 * 和 **,但不支持正则,也不影响同名目录。
- 安全写法:
"*.log"、"*.tmp"、".DS_Store" - 危险写法:
"log"—— 会把blog.md、application-log.txt全干掉 -
"*.pyc"只能隐藏顶层.pyc文件,对__pycache__/xxx.pyc无效;真要彻底过滤,得把"__pycache__"加进folder_exclude_patterns - 修改后不会自动刷新侧边栏,必须手动触发
Refresh Folder(快捷键Ctrl+Shift+P→ 输入回车)
为什么改了设置侧边栏还是显示被排除项?
常见原因就三个:
- 用了
file_exclude_patterns却想隐藏文件夹(比如__pycache__)——它只管文件,得换到folder_exclude_patterns - 没开
show_hidden_files却想过滤.DS_Store或.gitignore—— macOS/Linux 隐藏文件默认不扫描,得先设"show_hidden_files": true - 配置改了但没保存,或保存后没刷新文件夹——Sublime 不监听配置变更,必须手动
Refresh Folder或重启项目
最易忽略的一点:项目设置优先级高于用户设置,如果全局和项目里都写了 folder_exclude_patterns,项目里的会覆盖全局的。调试时建议先清空用户设置,只在项目里配,避免叠加干扰。











