sublime项目本质是保存当前已打开文件夹的配置,需先通过“open folder”加载目录再“save project as”生成.sublime-project文件,否则folders为空;添加多文件夹须手动“add folder to project”并再次“save project”才生效。

Sublime 项目不是“新建”的,是“保存当前文件夹状态”生成的
Sublime 没有传统 IDE 的「新建项目向导」,它不创建空壳,也不预设模板。所谓“建项目”,本质就是把当前已打开的文件夹(或多个文件夹)固化成一个可复用的配置文件 .sublime-project。
常见错误现象:点 Project → Save Project As… 后生成的文件里 "folders" 是空数组,重启后什么都没加载——因为你根本没先打开任何文件夹。
- 必须先执行
File → Open Folder…(或拖拽整个目录到窗口),至少加载一个文件夹 - 再点
Project → Save Project As…,推荐保存在项目根目录下,比如myapp/myapp.sublime-project - 路径写成
"path": ".",而不是绝对路径,否则换机器就失效 - 保存后会自动生成同名的
.sublime-workspace文件,它只记你关掉时的标签页、光标位置等个人状态,不该提交到 Git
添加多个文件夹进同一个项目,必须手动保存才生效
一个项目可以管理多个不相关的目录,比如同时打开 src/ 和 dist/,或微服务中的 backend/ 和 frontend/。但这不是自动的,得靠主动添加 + 显式保存。
使用场景:前端开发要实时比对源码和构建产物;全栈项目需并行编辑前后端代码。
- 右键侧边栏空白处 →
Add Folder to Project,或菜单Project → Add Folder to Project - 添加后,
.sublime-project中的"folders"数组会多一条记录,支持独立配置folder_exclude_patterns和file_exclude_patterns - 关键一步:添加完必须再执行一次
Project → Save Project(注意不是Save Project As…),否则重启 Sublime 就丢失 - 别在
"folders"里写空对象或错字段名(如"path": ""),整个 section 会被跳过
项目设置(settings)优先级高但容易被误读
项目级 settings 确实能覆盖全局配置,但它只对当前项目内打开的文件生效,且会被更细粒度的设置(比如你右下角手动点的缩进方式)再次覆盖。
常见错误现象:改了 "tab_size": 2 却没生效,底部状态栏仍显示 Tab Width: 4。
- 验证是否生效:打开项目内任意文件,看底部状态栏的
Tab Size或Indent Using Spaces是否显示Project Override -
"encoding"是旧写法,新版应为"default_encoding";"word_wrap"要写true/false,不能写字符串 - 插件配置也走这里,例如让 ESLint 只在本项目启用:
"SublimeLinter.linters.eslint.disable": false,前提是插件本身支持该键名 - 修改
.sublime-project后,需关闭再重开项目(或用命令面板执行Project: Reload Project),否则不生效
切换项目不能靠“最近打开文件夹”,得用真正的 .sublime-project 文件
很多人误点 Project → Switch Project,结果跳转的是上次用 Open Folder… 打开的目录,不是你存好的项目配置——那只是 Sublime 记的「最近文件夹历史」,和项目无关。
正确做法是让 Sublime 加载一个完整的 .sublime-project 文件,它才真正还原文件夹结构、设置、分屏布局等。
- 快捷键
Ctrl+Alt+P(Windows/Linux)或Cmd+Opt+P(macOS)调出的是「最近通过Open Project加载过的 .sublime-project 文件」列表 - 首次使用需先通过
Project → Open Project…手动选中你的.sublime-project文件,之后才会出现在切换列表里 - 原生功能太简陋,建议装
Project Manager插件:它把项目当索引对象管理,支持模糊搜中文、按路径排序、自定义存储位置(默认在Packages/User/Projects/) - 一个窗口只能加载一个项目,想对比两个项目?用
View → Layout → Columns 2分屏,分别打开不同项目的文件夹
.sublime-project)管结构和规则,工作区文件(.sublime-workspace)管个人状态,而 Sublime 默认不自动保存后者——你得自己决定要不要用 Save Session… 来备份标签页。这三个东西混在一起,最容易漏掉重载、误提交、或以为改了 settings 就立刻全局生效。










