sublime text 便携版必须在 sublime_text.exe 同级目录下创建严格命名为 data 的文件夹,启动时自动检测并进入便携模式,所有配置、插件、缓存均存于该文件夹内。

Sublime Text 便携版必须有 Data 文件夹,且名称严格为 Data
直接把官网下载的安装版或任意解压后的 sublime_text.exe 拷进 U 盘,双击运行——它依然会往 %APPDATA%\Sublime Text 写配置,根本不算便携。真正起效的,是紧挨着 sublime_text.exe 的那个空文件夹:Data(首字母大写,其余小写,不能是 data、DATA 或 sublime_data)。启动时 Sublime 会自动检测同级是否存在该文件夹,存在即进入便携模式,并在其中生成 Packages/、Installed Packages/、Cache/ 等子目录。
验证是否生效:菜单 → Preferences → Browse Packages…,路径应显示为类似 D:\MyUSB\Data\Packages。如果看到 C:\Users\XXX\AppData\Roaming\Sublime Text\Packages,说明 Data 文件夹建错了位置或命名不对,删掉重来即可。
Package Control 安装失败?用 Python 3 兼容脚本执行控制台命令
便携版首次启动后,Ctrl+Shift+P 呼出命令面板,输入 Package Control: Install Package 报错或无响应,大概率是旧版 Python 2 脚本失效所致。必须用支持 Python 3.3+ 的新版安装代码。
按 Ctrl+` 打开 Sublime 控制台,粘贴并完整执行以下代码(注意不要漏掉哈希校验部分):
import urllib.request,os,hashlib; h ='df21e130d211cfc94d9b0905775a7c0f1e3d39e33b79698005270310898eea76'; pf ='Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); 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), please try manual install'% (dh, h))if dh != h else open(os.path.join(ipp, pf),'wb').write(by)
若执行后无报错,重启 Sublime,再试 Ctrl+Shift+P → Package Control: Install Package。仍失败则手动下载 Package Control.sublime-package,放入 Data\Installed Packages\(该目录需手动创建),再重启。
插件和配置不会自动迁移,Data 文件夹就是全部
你之前在其他电脑上装过的插件、改过的主题、自定义的快捷键,全都不在新 U 盘里——因为它们实际存于旧系统的 %APPDATA% 下,与当前 Data 无关。便携版从零开始,所有内容只认 Data 目录下的文件:
-
Data\Packages\User\Preferences.sublime-settings是你真正的全局设置 -
Data\Packages\Emmet\这类目录是你装的插件源码(非压缩包) -
Data\Installed Packages\存的是插件的.sublime-package缓存文件 -
Data\Cache\和Data\Local\可删,但建议备份时一并复制,避免首次启动卡顿
迁移或备份只需关掉 Sublime,复制整个 Data 文件夹;换电脑时,把 sublime_text.exe 和这个 Data 文件夹一起拷过去,双击即用。
别用 --data 参数启动,除非你明确要绕过 Data 自动机制
网上有些教程教你在 bat 里写 sublime_text.exe --data "sublime_data",这确实能指定数据目录,但它绕过了 Sublime 内置的便携检测逻辑,容易引发插件加载异常、缓存路径错位等问题。官方虽支持该参数,但对便携场景而言,它不是推荐路径,而是备用方案。
正确做法就是老老实实建好 Data 文件夹,让 Sublime 自己识别并管理路径。这样 Preferences → Browse Packages… 显示的路径才与插件实际存放位置一致,Package Control 才能稳定读写 Installed Packages 和 Packages,也方便你后续用云盘同步或脚本批量备份。
U 盘速度慢、插件多、缓存堆积,都可能导致首次启动变慢——这不是配置问题,是物理限制。只要 Data 在位、路径正确、Package Control 能调出,剩下的只是耐心等它把索引建完。











