Sublime Text项目数据由.sublime-project和.sublime-workspace文件成对保存,缺一不可;需通过“Save Project As…”定位惯用目录,关闭窗口后备份两个同名文件,并手动修正跨设备路径。

Sublime Text 本身不保存项目数据记录,所谓“多个项目的数据记录”实际是每个项目的 sublime-project 文件 + 对应的 sublime-workspace 文件,二者必须成对备份,缺一不可;单独备份 .sublime-project 会导致窗口布局、折叠状态、光标位置等全部丢失。
怎么找到所有项目文件?别手动翻文件夹
项目配置不是集中存储的,而是分散在你主动保存过项目的地方。最可靠的方式是:启动 Sublime → Project → Save Project As…,看弹出对话框默认路径——那就是你惯用的项目存放目录。常见位置包括:
- Windows:
C:\Users\{user}\Documents\Projects\或自定义路径 - macOS:
~/Documents/Projects/(注意终端中空格要写成Documents/Projects/) - Linux:
~/projects/或~/code/
重点:不要依赖“最近打开”菜单或侧边栏显示的路径,它们可能指向临时缓存或符号链接。真实路径只认你主动 Save Project As… 时选中的那个文件夹。
必须同时备份 .sublime-project 和 .sublime-workspace
这两个文件是一体两面:
-
myapp.sublime-project:只存项目结构(folders)、构建系统、设置覆盖项 -
myapp.sublime-workspace:存所有运行时状态(打开的标签页、分组、光标位置、折叠行、书签)
如果只拷 .sublime-project 到新机器,打开后会是空白工作区;如果只拷 .sublime-workspace,Sublime 启动时会报错 Unable to load project: no project file found。实操建议:
- 每个项目目录下,确认两个文件都存在且修改时间接近(相差几秒内)
- 用命令行批量检查:
find /path/to/projects -name "*.sublime-project" -exec ls -la {}.workspace \;(macOS/Linux),缺失的就补上 - 不要重命名
.sublime-workspace—— 它的文件名必须和.sublime-project完全一致,仅后缀不同
备份时跳过自动重建的 workspace 缓存
Sublime 在项目未关闭时会不断写入 .sublime-workspace,直接复制可能得到损坏版本。正确做法是:
- 先关闭对应项目的所有 Sublime 窗口(不是只关标签页,是整个窗口)
- 等待 2–3 秒,让 Sublime 写完最后的缓存
- 再复制两个文件;若发现
.sublime-workspace文件大小为 0 字节,说明它还没写完或被锁住,跳过这次,等下次正常退出后再试 - 不要备份
.sublime-workspace的备份副本(如myapp.sublime-workspace~或myapp.sublime-workspace.bak),这些是编辑器崩溃时的残骸,不能恢复
跨设备同步时路径差异最易出问题
项目文件里硬编码了绝对路径,比如 "folders": [{ "path": "/home/user/project-a" }]。迁移到新电脑后,如果路径变了,Sublime 会显示灰色文件夹图标,提示 Folder does not exist。解决办法只有两个:
- 在新机器上用
Project → Edit Projects手动更新path字段(适合项目少) - 用正则批量替换:
sed -i 's|/old/path|/new/path|g' *.sublime-project(Linux/macOS),Windows 可用 PowerShell 的(Get-Content x).replace(...)
真正容易被忽略的是:Sublime 不会自动修正 workspace 里的文件路径,即使 project 文件改对了,workspace 中已打开的标签页仍指向旧路径,导致双击后打不开——此时必须手动重新打开文件,或删掉 .sublime-workspace 让它重建(但会丢失所有布局状态)。











