便携版默认保存路径由data文件夹位置决定:它必须与sublime_text.exe同级、首字母大写、首次运行前创建,否则仍走%appdata%等系统路径。

便携版的默认保存路径由 Data 文件夹位置决定
Sublime Text 便携版没有“修改保存路径”的配置项,它的数据存储路径完全取决于 Data 文件夹是否存在、命名是否正确、以及是否与可执行文件同级。只要满足这三点,所有配置、插件、缓存、会话都会写入 Data 目录内,不会再碰 %APPDATA% 或 ~/Library/Application Support。
常见错误现象:改完设置后,Preferences → Browse Packages… 弹出的仍是系统路径(比如 %APPDATA%\Sublime Text\Packages),说明便携模式根本没生效。
-
Data必须是首字母大写、其余小写 —— 写成data、DATA、MyData都无效 - 必须与
sublime_text.exe(Windows)或sublime_text(macOS/Linux)在同一级目录,不能放在bin/Data或app/Data这类子路径下 - 必须在首次运行前创建;如果已误启动过,需先退出 Sublime,再手动删除系统路径下的对应目录(如 Windows 的
%APPDATA%\Sublime Text),否则旧数据残留会干扰识别
验证便携模式是否真正启用
最可靠的验证方式不是看文件夹有没有建,而是用编辑器自己确认路径。启动 Sublime 后,执行 Preferences → Browse Packages…,弹窗地址必须形如:
C:\path\to\sublime_text\Data\Packages
或 macOS/Linux 下:
/path/to/sublime_text/Data/Packages
如果显示的是 %APPDATA% 或 ~/Library/Application Support 路径,就说明 Sublime 没识别到便携模式,仍在用系统默认数据目录。
- 此时所有你在
Packages/User/Preferences.sublime-settings里写的配置,实际写入的是系统路径,迁移时一复制就丢 - 插件安装也会落到系统目录,便携包里空空如也
- 即使你手动把
Packages文件夹拖进Data,只要首次启动没走对流程,Sublime 仍可能拒绝加载
便携版迁移或备份只需拷贝 Data 文件夹
一旦确认 Preferences → Browse Packages… 指向 Data\Packages,整个环境就真正便携了。此时迁移或备份只需完整复制 Data 文件夹即可,无需单独处理 Packages/User 或插件目录。
- 不要只备份
Packages/User—— 缺少Installed Packages和Cache,插件无法加载,右键菜单和快捷键大概率失效 - 不要手动拼路径找
Data—— 不同系统、ST 版本(3/4)、是否带空格,路径构造规则差异大;始终以Browse Packages…弹窗为准 - 若打包分发,确保接收方解压后
sublime_text可执行文件与Data夹同级,且未被防病毒软件误删或重命名
为什么改了 Preferences.sublime-settings 还是存到系统目录?
因为配置文件写入位置不取决于你改了什么内容,而取决于 Sublime 启动时读取的数据根目录。如果你在用户设置里写了 "font_size": 13 却发现它出现在 %APPDATA%\Sublime Text\Packages\User\Preferences.sublime-settings,那说明 Data 文件夹从一开始就没被识别。
- 检查点优先级:先确认
Data存在且大小写/位置正确 → 再确认是否首次运行前创建 → 最后看Browse Packages…结果 - 别试图通过命令行参数(如
--data)绕过 —— ST 4 已移除该参数支持,强行加会导致启动失败 - macOS 用户特别注意:
Application Support中的空格必须为字面空格,不能写成Application\ Support;但这个细节只影响你手动删目录,不影响便携逻辑本身











