sublime text便携版启动前必须在sublime_text.exe同级目录创建严格命名为data(首字母大写)的空文件夹,否则默认写入%appdata%\sublime text导致u盘迁移失效;验证方式为preferences → browse packages…路径须指向u盘data\packages;package control需用python 3新版脚本安装,跨电脑同步只需完整复制data目录。

Sublime Text便携版启动前必须建好Data文件夹
不建这个文件夹,Sublime就永远往%APPDATA%\Sublime Text写配置,U盘一拔,所有设置全丢。关键不是“怎么装”,而是“启动前有没有那个叫Data的空文件夹”。它必须和sublime_text.exe在同一个目录下,名字严格为Data(首字母大写,其余小写),不能是data、DATA或SublimeData。
常见错误:
- 先双击
sublime_text.exe再建Data——已经写进系统目录了,得手动删掉%APPDATA%\Sublime Text再重来 - 把
Data建在子目录里,比如D:\SublimeText\bin\Data——Sublime只认同级目录 - 用.zip包解压后直接运行,没检查
Data是否存在
验证是否真进了便携模式:看Browse Packages…路径
菜单栏点Preferences → Browse Packages…,弹出的路径必须指向U盘上的Data\Packages,比如D:\SublimeText\Data\Packages。如果看到的是C:\Users\XXX\AppData\Roaming\Sublime Text\Packages,说明便携没生效。
这时候别急着装插件,先关掉Sublime,确认Data位置和命名无误,再重启。否则Package Control会装到系统目录,后续所有插件都白装。
Package Control必须手动安装,且脚本要适配Python 3
便携版首次启动后,Ctrl+Shift+P搜不到Package Control: Install Package——这是正常的。必须进控制台Ctrl+`,粘贴新版安装脚本:
import urllib.request,os,hashlib; h = 'df21e130d211cfc94d9b0905775a7c0f1e3d39e33b79698005270310898eea76'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); by = urllib.request.urlopen('http://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s)' % (dh, h)) if dh != h else open(os.path.join(ipp, pf), 'wb').write(by)
注意:
- 旧版含
urllib2的脚本已失效,Sublime Text 3+默认用Python 3.3+ - 如果控制台报
Error validating download,说明网络中间有代理或缓存污染,应手动下载Package Control.sublime-package,放进Data\Installed Packages\,再重启 - 执行成功后,必须重启Sublime,
Ctrl+Shift+P才能看到Package Control命令
跨电脑同步只需复制整个Data目录
便携版的同步本质是文件同步,不是账号同步。插件、主题、快捷键、用户设置,全存在Data里。换电脑时,只要把整个Data文件夹复制过去,和sublime_text.exe放同级,就能完全复原。
但要注意:
- 已安装的插件不会自动迁移——因为旧插件实际在系统盘的
Packages目录下,U盘里根本没有 -
Data\Packages\User是你唯一需要重点关注的子目录,所有手动改过的Preferences.sublime-settings、自定义快捷键、语法高亮规则都在这里 - 不要只同步
User目录而漏掉Installed Packages或Cache——有些插件依赖二进制文件或缓存数据,缺了会报错或功能异常
最稳的做法:整份Data压缩打包,定期覆盖备份。路径含中文或空格不影响,但别用第三方“绿色版打包器”,官网.zip包+Data文件夹才是唯一可靠路径。











