Sublime不支持多项目实时切换,项目本质是当前目录状态的静态快照;必须先Open Folder再Save Project,否则folders为空;路径推荐用"."而非绝对路径;添加多目录需Add Folder to Project并再次Save Project;原生Switch Project仅记录历史路径且不刷新,推荐ProjectManager插件;项目设置须置于顶层settings下且键名严格匹配。

Sublime 本身不支持“多个项目同时加载并自由切换”——它只允许一个窗口对应一个 .sublime-project 文件,所谓“多项目管理”,本质是快速保存、加载、索引这些静态配置文件。
为什么 Save Project As… 后 "folders" 是空数组?
因为你没先打开任何文件夹。Sublime 的项目不是“新建”的,而是“快照当前已打开的目录状态”。
- 必须先执行
File → Open Folder…(或拖拽整个目录到窗口),至少加载一个根目录 - 再点
Project → Save Project As…,否则生成的.sublime-project中"folders"就是[] - 路径推荐写成
"path": ".",而不是绝对路径,否则换机器或重装后失效 - 保存后自动生成同名的
.sublime-workspace文件,它只记光标位置、标签页等个人状态,不该提交到 Git
怎么把多个不相关目录加进同一个项目?
比如同时编辑 src/ 和 dist/,或微服务里的 backend/ 和 frontend/,得靠手动添加 + 显式保存。
- 右键侧边栏空白处 →
Add Folder to Project,或菜单Project → Add Folder to Project… - 添加后
.sublime-project的"folders"数组会多一条记录,支持独立配置folder_exclude_patterns - 关键一步:添加完必须再执行一次
Project → Save Project(注意不是Save Project As…),否则重启就丢失 - 别在
"folders"里写空对象或错字段名(如"path": ""),整个 section 会被 Sublime 跳过
原生 Switch Project 为什么经常失效?
Project → Switch Project 列出的是“最近通过 Open Project 加载过的 .sublime-project 文件”,不索引磁盘、不刷新路径、不支持搜索。
- 项目被移动或删除后,点进去直接报错:
Unable to open project: path does not exist - 没有快捷键轮换,也没有模糊匹配,纯靠记忆翻菜单
- 真正靠谱的解法是装
ProjectManager插件:它把所有.sublime-project索引进内存,支持中文关键词搜索、按路径排序、自动刷新 - 安装后用
Ctrl+Shift+P输入Project Manager: Quick Switch Project,就能秒切
项目设置(settings)为什么改了不生效?
项目级设置优先级确实高于用户设置,但生效条件非常严格。
- 必须写在
.sublime-project的顶层"settings"字段下,不能塞进"folders"或"build_systems"里 - 键名必须和用户设置完全一致,比如
"tab_size"写成"tabSize"就无效 - 验证是否生效:打开项目内任意文件,看底部状态栏是否显示
Tab Width: 2或Project Override -
"encoding"是旧写法,新版应为"default_encoding";"word_wrap"要写true/false,不能写字符串
最容易被忽略的一点:Sublime 的“项目”不是运行时概念,它不监听文件系统变化,也不自动同步新增文件夹——所有变更都必须手动触发 Add Folder 和 Save Project 才固化到配置里。想靠它做自动化工作流,会很快撞墙。











