Sublime Text 多项目管理需手动保存 .sublime-project 文件并正确配置 folders 数组,推荐存于根目录用 "path": ".";ProjectManager 插件可替代原生切换功能,支持模糊搜索与可靠索引。

Sublime Text 本身不支持“多项目并存于同一窗口”的切换逻辑,所谓“管理多个项目”,本质是管理多个 .sublime-project 文件,并通过窗口或插件加载它们——直接双击文件最稳,依赖 Project → Switch Project 最容易报 Unable to open project: path does not exist。
怎么保存一个真正可用的项目文件
必须先打开至少一个文件夹(File → Open Folder…),再执行 Project → Save Project As…。否则生成的 .sublime-project 中 "folders" 是空数组,重启后侧边栏一片空白。
- 推荐把
.sublime-project文件存放在项目根目录下,例如myapp/myapp.sublime-project,这样"path": "."就能稳定指向整个项目,避免硬编码绝对路径 - 保存后会自动生成同名的
.sublime-workspace文件——它只记录你关窗前开了哪些标签页、光标在哪、分屏怎么排,属于个人状态,不该提交到 Git - 如果只是临时加了文件夹但没点
Project → Save Project(注意不是Save Project As…),重启 Sublime 就会丢失所有添加项
如何在一个项目里加多个不相关文件夹
比如要同时编辑 frontend/ 和 backend/,或者 src/ 与 dist/,不能只靠“打开根目录”。得手动把它们都塞进同一个项目。
- 用
Project → Add Folder to Project…或右键侧边栏空白处选择该选项,逐个添加 - 每个添加的文件夹在
.sublime-project中表现为"folders"数组里的一个对象,支持独立配置"folder_exclude_patterns"(如["node_modules", ".git"]) - 添加完务必再点一次
Project → Save Project,否则改动不会写入磁盘 - 拖拽文件夹到侧边栏也能加,但同样要保存项目,否则只是临时视图
为什么改了项目设置没生效
项目级设置优先级高于用户设置,但必须严格落在 "settings" 字段下,且键名必须和用户设置(Preferences → Settings)完全一致。写错位置或拼错名字,等于白改。
- 错误写法:
"tab_size": 2放在顶层、"folders"外面,或塞进"build_systems"里 - 正确结构:
"settings": { "tab_size": 2, "translate_tabs_to_spaces": true, "font_size": 13 } -
"settings"不继承用户设置里的注释或空行——保存后 Sublime 会自动格式化 JSON,别指望靠注释区分环境 - 终端插件(如 Terminus)默认工作目录是当前文件所在路径,不是项目根;想让它进根目录,得在
"settings"里加"terminal": { "working_dir": "$project_path" }(需插件支持变量)
用 ProjectManager 插件绕过原生限制
原生 Project → Switch Project 只列最近加载过的 .sublime-project,且不清理已删除/移动的路径,点进去大概率报错。ProjectManager 是目前最可靠的替代方案。
- 安装后,
Ctrl+Shift+P输入Project Manager: Save Project,自动命名并存到默认目录(Packages/User/Projects/),不污染源码 -
Project Manager: Quick Switch Project支持模糊搜索、中文匹配、按路径关键词过滤,比原生菜单快得多 - 它真正把
.sublime-project当作一等公民索引,而不是依赖“最近打开”这个不可靠的状态 - SideBarEnhancements、GitGutter 这类插件默认按当前视图所在文件夹工作,不认项目边界;只有 ProjectManager 这类专为项目设计的插件,才真正读取
.sublime-project
最容易被忽略的一点:Goto Anything(Ctrl+P)默认只索引 "folders" 列出的路径,哪怕两个项目物理距离很近,只要没加进当前项目的 "folders",就搜不到——这不是性能问题,是设计如此。

















