Sublime Text 的安装目录与数据目录天然分离是官方设计:程序本体只负责运行,所有个性化配置(插件、主题、快捷键等)均存于独立的数据目录;便携版唯一判断依据是 sublime_text.exe 同级是否存在 Data 文件夹,该目录包含 Packages、Installed Packages 等子目录,缺一则无法完整迁移。

Sublime Text 的安装目录和数据目录天然就是分离的
官方设计如此,不是 bug 是 feature。程序本体(sublime_text.exe 或 macOS 上的 Sublime Text 应用)只负责运行,所有个性化内容——插件、主题、快捷键、设置、项目历史——全存在「数据目录」里,和安装位置完全无关。
这意味着你可以把程序装在 C:\Program Files\Sublime Text,但把配置存在 %APPDATA%\Sublime Text 3;也可以把整个便携版解压到 D:\Tools\SublimeText3,只要同级有 Data 文件夹,它就自动把数据写进去,绝不碰系统目录。
- Windows 安装版默认数据路径:
%APPDATA%\Sublime Text 3 - macOS 默认路径:
~/Library/Application Support/Sublime Text 3 - Linux 默认路径:
~/.config/sublime-text-3 - 便携版唯一判断依据:
sublime_text.exe同级是否存在Data文件夹
备份时只拷 Packages/User 目录根本不够用
很多人以为导出 Preferences.sublime-keymap 就等于备份了快捷键,结果迁移到新机器后 Ctrl+Shift+P 没反应、Emmet 的 Tab 不展开——问题不在 keymap 文件本身,而在它依赖的上下文。
Packages/User 确实是用户配置的核心,但它只是冰山一角。真正影响行为的还有:
-
Packages/User/Package Control.sublime-settings:控制哪些插件被启用,而插件自带命令和快捷键 -
Packages/User/Preferences.sublime-settings:比如tab_size、font_size、ignored_packages,这些会改变插件是否加载 -
Packages/下非 User 的插件文件夹:如手动安装的SideBarEnhancements,若没一起备份,快捷键绑定的命令就找不到 -
Cache/和Local/一般不用备份,但Local/Session.sublime_session若含未保存的窗口状态,删了就真丢了
迁移前必须确认 Data 目录结构完整
常见翻车场景:从同事那儿拿到一个「配置包」,解压双击运行,发现中文乱码、侧边栏右键没选项、Ctrl+` 打不开控制台。大概率是目录结构残缺。
一个可直接运行的便携配置包,根目录下必须包含:
-
sublime_text.exe(或对应平台的可执行文件) -
Data/文件夹,且内部至少有:Packages/、Installed Packages/、Settings/ -
Packages/下应有User/文件夹,里面得有Preferences.sublime-settings和Package Control.sublime-settings
如果只有 Packages/User 一堆 JSON 文件,那它只是份「配置快照」,不是完整环境,需要手动覆盖到你本机的数据目录里,还得自己补插件。
跨平台同步 Packages/User 要小心路径和换行符
把 Packages/User 用 Git 或网盘同步到 macOS 或 Linux,很容易遇到「配置生效但功能异常」。原因很具体:
- Windows 路径分隔符是反斜杠
\,macOS/Linux 是正斜杠/,某些插件(如SideBarEnhancements)的配置里硬写了路径,一同步就错 -
Preferences.sublime-settings中的font_face值,Windows 写"Consolas",macOS 得写"Menlo",混用会导致字体 fallback 失败 - JSON 文件用 Windows 编辑器保存,默认 CRLF 换行,虽然 Sublime 能读,但 Git 会报 diff 警告,长期同步易引入不可见差异
建议做法:用统一编辑器(如 VS Code)打开并保存为 LF 换行;font_face、ignored_packages 这类平台敏感项,拆成 Preferences (Windows).sublime-settings 和 Preferences (macOS).sublime-settings,靠系统自动加载。











