便携版Sublime需手动创建大小写敏感的Data目录,插件及配置均须存于其内才能真正便携;Package Control安装后需验证命令面板功能,ST4须用含sha256校验的新脚本,国内网络建议换热点;离线安装须按格式放入对应子目录,配置必须置于Data/Packages/User/下才生效。

便携版插件安装和普通安装本质一样,但所有路径必须指向 Data 目录内,否则插件不会加载。
必须先建好 Data 文件夹
Sublime 便携版不会自动创建 Data 目录,不手动建就默认用系统级配置路径(比如 %APPDATA%),那就不是“便携”了。
- 解压便携版后,在根目录下新建文件夹,严格命名为
Data(大小写敏感,不能是data或DATA) - 启动一次 Sublime,它会自动在
Data下生成Packages和Installed Packages子目录 - 后续所有插件、设置、缓存都只写入这个
Data目录,拔掉 U 盘换电脑也能原样运行
Package Control 安装失败的常见原因
控制台执行安装脚本后显示 “Success!” 不代表真能用,重点看命令面板里能否调出 Package Control: Install Package 并开始加载列表。
- ST4 用户必须用带
hashlib.sha256校验的新版脚本,老脚本(如含md5或无校验)会导致后续无法联网拉取插件列表 - 国内网络环境下,
Fetching list of available packages卡住或报 TLS 错误,换手机热点通常比改 hosts 或代理更可靠 - 如果已存在旧版
Package Control.sublime-package,先去Data/Installed Packages/里删干净再重装,残留文件会劫持命令通道
离线安装插件时路径和格式别搞混
手动放插件不是“扔进任意文件夹就行”,.sublime-package 文件和源码文件夹走的是完全不同的加载路径。
- 下载到的是
Emmet.sublime-package→ 直接丢进Data/Installed Packages/ - 下载的是 ZIP 包(如
emmet-master.zip)→ 解压,重命名文件夹为Emmet(去掉-master和版本号),整个文件夹拖进Data/Packages/ - 放进
Data/Packages/的文件夹名必须和插件功能名一致且大小写匹配,gitgutter和GitGutter是两个不同插件 - 重启 Sublime 后,打开控制台(
View → Show Console)看有没有报错,比如ImportError或找不到模块,说明依赖缺失或路径错误
最常被忽略的一点:便携版的 ignored_packages 配置如果写在系统级 Preferences.sublime-settings 里,它根本不会生效;所有配置必须放在 Data/Packages/User/Preferences.sublime-settings 中才起作用。

















