Sublime Text中如何设置侧边栏只显示特定项目文件？

本文共计765个文字，预计阅读时间需要4分钟。

ST3版本不支持show_hidden_files，任何配置都无效。必须升级到ST4 build 4126或更高版本（截至2026年最新稳定版已足够）。如果更改了设置但看不到.git、.env或.prettierrc，第一反应不应该是配置错误，而是版本不足。

验证方式：菜单 → Help → About，看 Build 号是否 ≥ 4126。低于这个数，"show_hidden_files": true 这行直接被忽略，不会报错，也不会生效。

show_hidden_files 必须加在 settings 字段下，不能塞进 folders

很多人把 "show_hidden_files": true 写进 folders 数组里，比如：

{ "folders": [ { "path": ".", "show_hidden_files": true // ❌ 错误位置，完全无效 } ] }

正确写法是把它放在项目配置的顶层 settings 字段中：

{ "folders": [ { "path": "." } ], "settings": { "show_hidden_files": true // ✅ 正确位置 } }

同样适用于用户设置（Preferences → Settings 右侧）——也必须放在根级 JSON 对象里，不能嵌套进其他字段。

folder_exclude_patterns 和 file_exclude_patterns 是“额外过滤”，不是开关

开了 show_hidden_files 后，.git 依然不出现？大概率是因为 folder_exclude_patterns 里还留着 ".git"。

• folder_exclude_patterns 只对目录名生效："node_modules"、".git"、"__pycache__" 都该放这里
• file_exclude_patterns 只对文件名生效："*.log"、".env"、"*.pyc" 才该放这里
• 二者都不支持正则："^\."、".*"、"**/*.md" 全部无效，只认 glob 前缀匹配（如 "*.tmp" 有效，"tmp" 会误杀 atmp.js）
• 数组不合并：项目配置里写了 "folder_exclude_patterns": [".git"]，那全局设置里的同名字段就彻底失效

侧边栏为空？可能根本没加载项目目录

用 File → Open File… 打开单个 index.js，侧边栏天然为空——这不是 bug，是设计。Sublime 的侧边栏只响应「项目上下文」。

必须通过以下任一方式加载目录结构：

• File → Open Folder…（Windows/Linux）
• File → Open… 并选中一个文件夹（macOS）
• 已有 .sublime-project 文件，双击打开或用 Project → Open Project…

另外注意两个静默失败点：

• 路径含符号链接（symlink）：默认不跟随，目标目录再正常也不会出现
• 挂载路径（如 WSL2 的 /mnt/c/Users/xxx、macOS APFS 快照卷）：Sublime 可能静默跳过，无错误提示，侧边栏就是空的

真正容易被忽略的是：即使所有配置都对，只要没走「Open Folder」这一步，show_hidden_files 就永远没机会起作用。