根本原因是Data文件夹未正确创建:必须与sublime_text.exe同级、严格命名为Data(首字母大写),否则Sublime退回到%APPDATA%写配置;验证方式为Preferences → Browse Packages…路径须显示U盘/Data/Packages。

Sublime便携版为什么启动后配置还在%APPDATA%里
根本原因只有一个:Data 文件夹没建对。它必须和 sublime_text.exe 在同一级目录,名称严格为 Data(首字母大写,其余小写),不能是 data、DATA、MyData 或任何变体。
常见错误包括:
- 把
Data建在子目录下,比如bin/Data或app/Data - 已误双击运行过
sublime_text.exe,导致系统路径下生成了残留配置,此时需先删掉%APPDATA%\Sublime Text再重试 - 用的是官网 .exe 安装包而非 .zip 包——只有官方 .zip 包才支持原生便携模式
验证是否生效的唯一可靠方式:菜单 → Preferences → Browse Packages…,路径必须显示为类似 D:\MyUSB\SublimeText\Data\Packages。如果不是,就说明没走便携通道。
如何确保每次从U盘双击都走便携路径
Windows 下直接双击 sublime_text.exe 会忽略同级 Data 文件夹,退回到系统默认行为。必须用启动参数强制指定数据目录。
正确做法是创建一个 start.bat 文件,内容为:
sublime_text.exe --data "SUBLIME_DATA"
注意要点:
-
start.bat和sublime_text.exe必须在 U 盘根目录同一级 -
SUBLIME_DATA是相对路径名,U 盘上会自动生成该文件夹;也可写成绝对路径如"%~dp0SUBLIME_DATA"更稳妥 - 以后只双击
start.bat,永远不要点sublime_text.exe本身 - 首次运行后检查
SUBLIME_DATA\Packages\User\Preferences.sublime-settings是否生成——这是你真实配置的落点
Package Control装不上?别怪网络,先看环境有没有切进去
控制台执行安装脚本后报错、无响应、或重启后找不到 Package Control: Install Package,大概率不是网络问题,而是脚本运行时仍指向系统路径。
关键前提:
- 必须确认
Data已存在且Browse Packages…显示路径正确,否则sublime.installed_packages_path()返回的是%APPDATA%路径,插件会装错地方 - 老教程里的 Python 2 脚本(含
urllib2)已彻底失效,必须用 Python 3.3+ 新版脚本(含urllib.request和 SHA256 校验) - 若执行后提示
Error validating download,说明下载内容哈希不匹配——常见于代理/防火墙篡改或缓存污染,此时应手动下载Package Control.sublime-package,放进SUBLIME_DATA\Installed Packages\(该目录需手动创建),再重启
U盘格式和跨设备同步最容易被忽略的硬伤
FAT32 格式的 U 盘无法存储大于 4GB 的单个文件,而某些插件(如 LSP 服务端、大型语言模型插件)或索引缓存可能突破此限,导致首次运行卡死或后续异常。
同步时也容易踩坑:
- 只同步
Data文件夹,却忽略sublime_text.exe本身——不同 Build 版本的二进制文件与插件兼容性可能不一致 - 用 Dropbox / OneDrive 同步时未等待全部文件上传完成就拔出 U 盘,造成
Cache/或Index/目录损坏 - Git 同步未加
.gitignore排除Cache/、Local/Session.sublime_session等运行时文件,导致冲突或隐私泄露
真正可靠的便携,是整个目录(含可执行文件 + Data)作为一个原子单元被复制或同步——少一个环节,下次在客户电脑上打开就可能变成“全新安装”。


















