sublime text 项目设置通过 .sublime-project 文件迁移,但需手动处理路径、插件、快捷键、配色方案和构建系统等隐式依赖;该文件为json格式,应使用相对路径(如"path": "."),并配合packages/user配置及插件文件一并导出。

Sublime Text 没有项目设置的“导出/导入”菜单,所谓项目设置,就是你打开一个文件夹后通过 Project → Save Project As… 保存下来的 .sublime-project 文件——它本身就是一个纯文本 JSON,直接复制粘贴就能迁移,但容易漏掉隐式依赖。
怎么找到并导出当前项目的 .sublime-project 文件
项目设置不是全局配置,它只在你主动保存项目时才生成。如果你没点过 Save Project As…,那根本不存在这个文件,Sublime 此时用的是临时会话(关闭后就丢)。
- 确认是否已保存项目:菜单栏
Project → Edit Project能打开编辑窗口,说明已有.sublime-project;打不开或提示“no project”,就先存一个 - 文件位置分两种情况:
– 如果你用Save Project As…存到了某个路径(比如/myproject/myproject.sublime-project),那就去那里找
– 如果你只是打开文件夹后点“Save Project As…”,Sublime 默认会把文件放在该文件夹根目录下,和.git或README.md并列 - 别从
Packages/User里翻——项目文件不会自动放那儿,它只存在于你指定的位置
导入项目设置时,为什么打开 .sublime-project 没反应
双击 .sublime-project 文件或用 File → Open Project… 打开后,Sublime 界面没变化、侧边栏还是空的,大概率是路径字段写死了本地绝对路径,而新机器上根本不存在那个目录。
- 用文本编辑器打开
.sublime-project,检查"folders"数组里的"path"值:如果写的是"C:\Users\Alice\code\myapp"或"/home/alice/myapp",迁移到别人电脑上必然失效 - 安全写法是用相对路径:
"path": "."(表示项目文件所在目录),或留空让使用者手动添加文件夹 - 如果项目里用了自定义构建系统(
.sublime-build),确保它们也在同一目录下,或者路径在"build_systems"里是相对的,否则构建命令会报Unable to find build system
项目设置里哪些内容不能靠 .sublime-project 文件迁移
.sublime-project 只管结构和显式配置,它不包含插件状态、快捷键覆盖、配色方案文件这些——它们全在 Packages/User 或插件目录里,必须单独处理。
- 插件启用状态存在
Packages/User/Package Control.sublime-settings的"installed_packages"字段里,漏掉它,项目打开后插件全灰 - 项目专属快捷键(比如只在该项目里
Ctrl+B运行 npm test)得写在Packages/User/MyProject.sublime-keymap这类文件里,.sublime-project不管这个 - 配色方案如
"color_scheme": "Packages/Dracula Color Scheme/Dracula.tmTheme"是个路径引用,真实.tmTheme文件得一并拷过去,否则 fallback 到默认主题 - 构建系统中调用的脚本(比如
npm run dev)依赖本地环境,.sublime-project不打包 Node.js 或 Python 解释器
真正能“一键迁移项目”的,是把 .sublime-project + Packages/User 目录 + 对应插件文件夹(如 Packages/EmmyLua)一起打包——但要注意,插件目录体积大,且有些插件行为受系统级配置影响,比如 Terminal 插件调用的是你本机的 shell 路径。











