Sublime Text的“项目”本质是加载.sublime-project文件以重置窗口上下文,未保存该文件则无项目概念;必须通过Project→Save Project As…手动保存,否则重启后折叠状态、构建系统、Goto Anything索引等全部丢失。

Sublime Text 不能在一个窗口里“切换项目”,所谓快速切换,本质是加载不同的 .sublime-project 文件并启动新窗口——没生成这个文件,就等于没项目,所有状态都会丢。
为什么刚打开文件夹,重启后侧边栏就空了?
因为只点了 File → Open Folder…,没执行 Project → Save Project As…。此时 Sublime 不会生成 .sublime-project,也就没有项目上下文:折叠状态、构建系统、Goto Anything(Ctrl+P)索引范围全丢失。
- 必须先打开至少一个文件夹,再手动触发
Project → Save Project As… - 推荐把
.sublime-project文件存放在项目根目录下(如myapp/myapp.sublime-project),这样配置中写"path": "."才能稳定生效 - 保存后自动生成同名的
.sublime-workspace文件,它只记录标签页、光标、分屏等个人状态,不该提交到 Git
如何让多个不相关文件夹(比如 frontend + backend)共存于一个项目?
不能靠“打开父目录”来覆盖,得显式添加并保存。否则 Ctrl+P 搜不到 backend 下的文件,侧边栏也只显示 frontend。
- 用
Project → Add Folder to Project…或右键侧边栏空白处选择该选项,逐个添加路径 - 每个添加项在
.sublime-project中表现为"folders"数组里的一个对象,支持独立配置"folder_exclude_patterns"(如["node_modules", ".git"]) - 添加完务必再点一次
Project → Save Project(注意不是Save Project As…),否则改动不会写入磁盘 - 拖拽文件夹到侧边栏也能加,但同样不保存——关掉窗口就消失
为什么 Project → Switch Project 列表为空或点开报错?
这个菜单只显示你亲手通过 Project → Open Project 加载过的 .sublime-project 文件,不是磁盘上所有同名文件。双击 .sublime-workspace 也无效,因为它不存路径,只存状态。
- 首次加载必须用
Project → Open Project(不能双击,也不能拖拽) - 加载成功后,窗口标题栏会显示项目名(如
myapp — Sublime Text),这是唯一可靠信号 - 如果列表为空,说明你还没真正加载过任何项目:先
File → Open Folder…,再Project → Save Project As…,最后Project → Open Project选它 - 报错
Unable to open project: path does not exist,大概率是.sublime-project被移动、重命名或删除了;.sublime-workspace里写的"project": "./myapp.sublime-project"就失效了
想真正隔离前端和后端,该开一个窗口还是两个?
开两个窗口。Sublime 的每个窗口只能绑定一个 .sublime-project,Add Folder to Project… 是把另一个目录挂进当前项目,不是隔离环境——所有设置、折叠状态、构建系统仍共享。
- 前端开一个窗口,加载
frontend.sublime-project;后端另开一个,加载backend.sublime-project - 每个
.sublime-project可配独立"settings"(如"tab_size": 2或"font_size": 13),互不影响 - 别把
.sublime-project放在 Sublime 安装目录或Packages/下——路径解析会失效,侧边栏可能空白 - Terminal 类插件默认工作目录是当前文件所在路径,不是项目根;想让它进根目录,得在
"settings"里加"terminal": { "working_dir": "$project_path" }(需插件支持)
最易被忽略的一点:所有项目级设置必须严格落在 "settings" 字段下,且键名必须和用户设置完全一致。写错位置(比如塞进 "build_systems")、拼错名字(如 "fontsize" 写成 "font_size"),等于白改。


















