核心是创建并持久化.sublime-project文件:必须先打开文件夹再Save Project As…生成初始文件,添加文件夹后须手动Save Project(非Save Project As…),否则重启即丢失;设置须置于"settings"对象内且键名精确匹配,修改后需Reload Project才能生效。

Sublime Text 管理多文件夹项目,核心不是“加几个文件夹”,而是「建一个真正可用的 .sublime-project 文件并让它持久生效」——漏掉保存、路径写错、没重载,侧边栏就空着,设置全失效。
为什么添加了文件夹却没出现在侧边栏?
常见错误是:只点 Project → Add Folder to Project…,但没执行 Project → Save Project(注意不是 Save Project As…)。.sublime-project 文件不会自动更新,不手动保存,重启 Sublime 后所有添加项都会消失。
- 必须先有至少一个文件夹打开(
File → Open Folder…),再点Save Project As…生成初始文件;否则"folders"是空数组 - 添加多个文件夹后,务必再点一次
Project → Save Project,否则改动仅存在于内存中 - 拖拽文件夹到侧边栏也能临时显示,但同样不持久,关窗即丢
如何让 frontend/ 和 backend/ 同时在同一个项目里?
不能靠“打开根目录”一步到位。必须把它们作为独立条目塞进 "folders" 数组,且各自可配排除规则。
- 用
Project → Add Folder to Project…分别添加frontend/和backend/ - 编辑项目文件:
Project → Edit Project,确认"folders"是数组,每个对象含"path"字段,例如:{"path": "frontend"}、{"path": "backend"} - 可在每个文件夹对象里加
"folder_exclude_patterns",比如{"path": "backend", "folder_exclude_patterns": ["node_modules"]} - 路径推荐用相对路径(如
"."或"frontend"),避免硬编码绝对路径导致换机器失效
改了项目设置(如 tab_size)为什么不生效?
项目级设置必须严格落在 "settings" 对象内,且键名必须和用户设置完全一致;写错层级或拼错名字,等于没写。
- 错误位置:
"tab_size": 2直接写在.sublime-project根层级,或塞进"build_systems"里 - 正确结构:
"settings": { "tab_size": 2, "translate_tabs_to_spaces": true } - 改完设置后,必须执行
Project → Reload Project(或快捷键Ctrl+Alt+P→ 输入 “reload”),仅保存文件不触发重载 -
.sublime-workspace不继承项目设置,它只管窗口布局、光标位置等会话状态,不该提交到 Git
怎样切换项目才不报 Unable to open project: path does not exist?
别依赖 Project → Switch Project… 菜单——它只扫描启动时存在的项目路径,删了/移了文件夹就立刻失效。最稳的方式是双击 .sublime-project 文件。
- 每个项目根目录下存一个
myapp.sublime-project,内容里"path": "."就能稳定指向自身 - 用文件管理器双击打开该文件,Sublime 会以新窗口加载完整上下文(打开的标签页、折叠状态、书签)
- 如果非要单窗口切换,装
ProjectManager插件,它能实时索引磁盘上的.sublime-project文件,支持模糊搜索,比原生菜单可靠得多 -
Switch Project的快捷键Ctrl+Alt+P实际调用的是插件命令,原生菜单本身不维护动态路径列表
最易被忽略的一点:Sublime 的“项目”本质是静态 JSON 配置,没有后台进程帮你同步状态。所有操作——添加、修改、保存、重载——都得手动触发,少一步,整个工作区就断连。

















