sublime text 启动后仍往 %appdata% 写配置,最常见原因是 data 文件夹未与 sublime_text.exe 同级放置且名称未严格设为“data”(首字母大写、其余小写);验证方式为 preferences → browse packages… 路径须显示为 data\packages,否则需删除系统旧配置并重试。

Sublime Text 启动后仍往 %APPDATA% 写配置?Data 文件夹建错位置了
便携失效的最常见原因,就是 Data 文件夹没放对地方。它必须和 sublime_text.exe 在同一级目录,且名称严格为 Data(首字母大写,其余小写),不能是 data、DATA 或 MyData。
验证是否生效:菜单 → Preferences → Browse Packages…,路径必须显示为类似 D:\MyUSB\SublimeText\Data\Packages。如果看到 C:\Users\XXX\AppData\Roaming\Sublime Text\Packages,说明 Sublime 根本没识别到便携模式,得删掉系统里的旧配置目录重来:
- Windows 下删掉
%APPDATA%\Sublime Text(或%APPDATA%\Sublime Text 3) - macOS 下删掉
~/Library/Application Support/Sublime Text - 确保
Data已存在,再双击sublime_text.exe启动
用 --data 参数启动才真正可控,别信“解压即用”
官网 ZIP 包(如 Sublime Text Build 4162 x64.zip)解压后只有可执行文件和 DLL,它默认不启用便携逻辑。靠 Data 文件夹自动触发的方式虽可行,但有兼容性风险——某些旧系统或企业镜像会忽略该机制,仍 fallback 到 %APPDATA%。
最稳的做法是强制指定数据目录:
- 在 U 盘根目录放
start.bat,内容为:sublime_text.exe --data "Data" - 确保
sublime_text.exe和start.bat同级,Data是相对路径 - 以后只双击
start.bat,永远不要直接点sublime_text.exe - 首次运行后检查
Data\Packages\User\Preferences.sublime-settings是否生成 —— 这才是你真正的配置落点
Package Control 安装失败?不是网络问题,是没进便携通道
控制台执行安装脚本后报错、无响应,或重启后 Ctrl+Shift+P 找不到 Package Control: Install Package,大概率是因为脚本运行时 sublime.installed_packages_path() 返回的是系统路径,插件被装到了 %APPDATA% 里。
必须确认 Data 已生效后再操作:
- 用新版 Python 3 脚本(含
urllib.request和 SHA256 校验),老版urllib2已彻底失效 - 若提示
Error validating download,不是脚本错了,而是下载内容被代理/防火墙篡改,此时应手动下载Package Control.sublime-package,放进Data\Installed Packages\(该目录需手动创建) - 重启后再次调用命令,它才会在
Data\Packages\Package Control\下建立缓存
U 盘 FAT32 格式会导致插件安装失败或崩溃
这是最容易被忽略的底层限制。FAT32 不支持大于 4GB 的单文件,而某些插件(如 LSP 服务、大型语法包)或 Sublime 自身缓存可能突破此限;更隐蔽的是,FAT32 缺乏文件权限和原子写入语义,Data\Cache 或 Data\Index 目录在频繁读写时容易损坏,表现为插件突然消失、索引卡死、甚至 sublime_text.exe 启动黑屏。
解决方法很简单但常被跳过:
- 将 U 盘格式化为
exFAT(Windows/macOS/Linux 均原生支持,无 4GB 限制)或NTFS(仅 Windows 兼容性最好) - 避免把整个 Sublime 目录塞进 U 盘根目录下带中文或空格的路径,比如
D:\我的工具\SublimeText\Data,容易触发参数截断或编码异常 - 如果必须用 FAT32,至少禁用索引功能:在
Data\Packages\User\Preferences.sublime-settings中加一行:"index_files": false











