Sublime Text“新建项目”实为保存已打开文件夹为.sublime-project文件,需先Open Folder再Save Project As;切换项目应使用Quick Switch Project而非Open Project,且.sublime-project须含绝对路径的folders数组并纳入版本控制。

Sublime Text 新建项目:不是“新建空项目”,而是“保存当前文件夹为项目”
Sublime Text 没有“新建空白项目”的概念,所谓“新建项目”,本质是把已打开的文件夹(或多个文件夹)保存为一个 .sublime-project 文件。它不生成目录结构,只记录路径和配置。
操作流程很简单:
- 先通过 File → Open Folder… 或拖拽文件夹到侧边栏,让目标目录出现在左侧边栏中
- 再执行 Project → Save Project As…,输入项目名(如
myapp.sublime-project),建议保存在项目根目录内 - 保存后自动生成两个文件:
myapp.sublime-project(定义项目内容)和myapp.sublime-workspace(记录你当前打开哪些文件、光标在哪、是否分屏等)
注意:.sublime-workspace 是个人状态文件,不应提交到 Git;而 .sublime-project 可以也**应该**加入版本控制,方便团队共享基础设置(比如 folders、settings、build_systems)。
切换项目:用 Quick Switch Project,别用 Open Project
频繁切换时,Project → Open Project 会在新窗口打开项目,导致窗口泛滥;真正高效的方式是 Project → Quick Switch Project(默认快捷键 Ctrl+Alt+P / Cmd+Alt+P)——它在当前窗口直接加载另一个项目的 .sublime-project,同时恢复对应 .sublime-workspace 中的标签页、折叠状态、光标位置。
常见问题:
- 快捷键没反应?检查是否被其他插件占用,可在 Preferences → Key Bindings 中搜索
quick_switch_project - 列表里没有刚保存的项目?重启 Sublime 或执行一次 Project → Refresh Projects
- 切换后侧边栏空了?说明该项目的
.sublime-project中folders字段为空或路径错误,用 Project → Edit Project 手动补上
.sublime-project 文件里必须写清楚 folders
很多人保存项目后发现切换过去侧边栏没内容,根本原因是 .sublime-project 的 JSON 结构里漏了 folders 数组。它不是可选字段,而是项目存在的前提。
正确示例:
{
"folders":
[
{
"path": "/Users/you/dev/myapp"
}
],
"settings":
{
"tab_size": 2,
"translate_tabs_to_spaces": true
}
}
关键点:
-
path必须是绝对路径(Windows 用C:\path\to\folder,macOS/Linux 用/full/path/to/folder) - 支持多个
folder对象,适合跨目录协作场景(如前端 + 后端代码不在同一根下) - 可用变量如
$project_path替代硬编码路径,但仅在部分上下文生效(如构建系统),folders.path不支持
SideBarEnhancements 插件让项目管理更顺手
原生 Sublime 的侧边栏功能较弱,装上 SideBarEnhancements 后,右键菜单立刻多出一堆实用项:快速新建文件/文件夹、在终端中打开当前路径、复制路径、刷新侧边栏等。它不替代项目机制,但极大缓解“每次建结构都要切终端”的痛点。
安装后典型操作:
- 在侧边栏空白处右键 → New File 或 New Folder,直接创建,无需
mkdir/touch - 右键某个文件夹 → Open in Terminal(macOS/Linux)或 Open in CMD(Windows),快速执行脚手架命令(如
npm init、cookiecutter) - 右键文件 → Copy Path,粘贴进
.sublime-project的folders字段里,避免手敲出错
真正麻烦的从来不是“怎么切换”,而是项目初始化时目录没搭好、folders 路径写错、或者误把 .sublime-workspace 提交进仓库导致别人打开后布局错乱——这些细节比快捷键重要得多。


















