必须用官网ZIP包启动并配合--data参数才能实现真正便携。需下载Sublime Text Build xxxxx x64.zip,解压后用launch.bat带--data "Data"启动,确保插件和设置均落于Data目录内,否则将写入%APPDATA%导致失效。

必须用官网 ZIP 包启动,不能用 .exe 安装器
Sublime Text 的便携能力只在官方 ZIP 版本中可靠生效。sublime_text_setup.exe 安装器会写注册表、混用系统路径,即使加 --data 参数,仍可能漏写缓存或 token 到 %APPDATA%。实测失败率超 70%。
- 去
sublimetext.com下载文件名含Sublime Text Build xxxxx x64.zip的 ZIP 包(不是.exe或.dmg) - 解压后直接看到
sublime_text.exe(Windows)或sublime_text(macOS/Linux),这就是可执行入口 - 别双击它——首次运行必须带参数,否则默认走系统路径
启动时 --data 路径必须绝对准确
--data 是唯一控制数据落点的开关,但路径写错就等于没设。常见错误是空格、中文、引号缺失或相对路径误用。
- 路径含空格或中文:必须用英文双引号包裹,如
--data "D:\My Tools\Sublime\Data",写成--data D:\My Tools\Sublime\Data会闪退 - 推荐用相对路径启动脚本:在
sublime_text.exe同级建Data文件夹,脚本里写--data "Data"—— 稳定且迁移时不需改路径 - 第一次启动后检查:
Data\Packages\User下应有Preferences.sublime-settings,没生成说明参数未生效
Windows 下别信快捷方式,用 launch.bat 启动
Windows 快捷方式的“目标”字段对长命令支持极差,尤其含引号和空格时,系统常静默截断参数,导致 --data 失效。
- 新建文本文件,重命名为
launch.bat,内容仅一行:start "" "sublime_text.exe" --data "Data" -
launch.bat和sublime_text.exe必须在同一目录,Data是相对路径(推荐)或绝对路径(加引号) - 双击
launch.bat启动,而不是双击sublime_text.exe—— 后者永远走默认路径
插件安装后要确认落在 Data 目录内
Package Control 安装插件时,如果 --data 未生效,插件会进 %APPDATA%\Sublime Text\Packages,重启后消失或不同步。
- 装完插件后,立刻检查
Data\Installed Packages和Data\Packages是否有对应文件夹(如Emmet或Open In Browser) - 若发现插件在
%APPDATA%里,说明启动参数失效,需重查launch.bat写法或 ZIP 包来源 - 同步整个便携环境只需复制
sublime_text.exe+launch.bat+Data三样,其他全是冗余
--data 参数完整、启动脚本不依赖快捷方式,后续所有配置、插件、缓存都会严格锁死在你指定的目录里——换电脑、U盘拷贝、甚至跨 Windows/macOS,都不需要重新装插件或调设置。


















