sublime便携版必须在sublime_text.exe同级目录下严格创建首字母大写、其余小写的data文件夹,否则仍写入%appdata%;启用便携模式后所有配置、插件均存于data目录,验证路径应为u盘路径而非系统路径。

Sublime便携版必须有同级Data文件夹,否则根本不算便携
直接把官网下载的 sublime_text.exe 拷进U盘双击运行,它默认仍会往 %APPDATA%\Sublime Text 写配置——你看到的插件消失、主题重置、快捷键还原,全是因为实际数据根本没落在U盘上。
真正起效的唯一条件是:sublime_text.exe 所在目录下必须存在一个**严格命名为 Data(首字母大写,其余小写)的空文件夹**,且不能是 data、DATA、SublimeData 或任何变体。启动时 Sublime 会自动检测这个文件夹,存在即进入便携模式,并在其中生成 Packages/、Installed Packages/、Cache/ 等子目录。
验证是否生效:菜单 → Preferences → Browse Packages…,路径必须显示为类似 D:\MyUSB\Data\Packages;如果看到 C:\Users\XXX\AppData\Roaming\Sublime Text\Packages,说明 Data 文件夹建错了位置或命名不规范,删掉重来即可。
用 --data 参数启动最稳,别依赖自动识别
靠 Data 文件夹自动触发便携模式,在某些旧系统、企业镜像或特殊权限环境下可能失效——Sublime 会 fallback 到系统路径。最可控的方式是显式指定数据目录。
在U盘根目录(与 sublime_text.exe 同级)新建一个 start.bat 文件,内容为:
sublime_text.exe --data "Data"
以后只双击运行这个 start.bat,永远不要直接点 sublime_text.exe。首次运行后检查 Data\Packages\User\Preferences.sublime-settings 是否生成——这才是你真正的配置落点。
-
--data后的路径支持相对路径(如"Data")或绝对路径(如"D:\MyUSB\Data") - 确保
start.bat和sublime_text.exe在同一级目录 - Windows 下若提示“找不到命令”,需确认
sublime_text.exe名称未被重命名(如改成subl.exe就会失败)
Package Control 安装失败?先确认已进便携通道
控制台执行安装脚本后报错、无响应,或重启后 Ctrl+Shift+P 找不到 Package Control: Install Package,大概率不是网络问题,而是脚本运行时 sublime.installed_packages_path() 返回的是系统路径,插件被装进了 %APPDATA% 而非U盘的 Data 目录。
务必在确认 Data 已生效后再操作:
- 用新版 Python 3 脚本(含
urllib.request和 SHA256 校验),老版urllib2已彻底失效 - 按
Ctrl+`打开控制台,粘贴并完整执行官方推荐脚本(含哈希校验部分) - 若提示
Error validating download,说明下载内容被代理/防火墙篡改,此时应手动下载Package Control.sublime-package,放入Data\Installed Packages\(该目录需手动创建),再重启
重启后再次调用命令,它才会在 Data\Packages\Package Control\ 下建立缓存。
同步和迁移时最容易忽略的点
便携版的同步本质是文件同步,不是账号同步。只要 Data 目录完整,一切就都在里面——但很多人只同步 Data,却忽略了 sublime_text.exe 本身版本差异带来的兼容性问题。
推荐做法是把整个 Sublime 目录(含 sublime_text.exe + Data)一起放入 OneDrive / Syncthing / rsync 等工具同步;否则不同设备上运行不同 Build 版本的可执行文件,可能导致插件加载失败、API 不兼容或设置解析异常。
另外,部分插件(如 GitGutter、SideBarEnhancements)会在 Data\Packages\<plugin_name>\</plugin_name> 下生成本地状态文件或缓存,这些也必须随 Data 一并同步,否则功能表现不一致。











