便携版sublime需手动创建data目录并用控制台安装package control。先建data文件夹,再运行控制台脚本安装;失败则手动下载package control.sublime-package放入data/installed packages/;最后验证browse packages路径是否为便携目录内。

便携版必须先建 Data 目录,否则 Package Control 无法存配置
Sublime 便携版启动时默认不创建 Data 目录,而 Package Control 的所有插件、缓存、用户设置都依赖这个目录。没它,你装的插件重启就丢,控制台里会反复报 No such file or directory: 'Data' 或直接静默失败。
操作很简单:在解压后的 Sublime 根目录下,手动新建一个名为 Data 的文件夹(注意大小写,不能是 data 或 DATA)。Windows 下右键 → 新建 → 文件夹 → 改名;macOS/Linux 下终端执行:
mkdir Data。之后再首次运行
sublime_text.exe(或对应可执行文件),它就会自动把插件、缓存、日志全写进这个 Data 目录。
用控制台安装 Package Control,别点菜单里的 “Install Package Control”
菜单里那个 Tools → Install Package Control 是个假入口——它只对安装版有效,便携版点击后无反应或报错 AttributeError: 'NoneType' object has no attribute 'installed_packages_path',因为路径没初始化。
正确做法是打开控制台(Ctrl + `),粘贴当前有效的 Python3 安装脚本(2026 年仍可用):
import urllib.request,os,hashlib; h = '2915d1851351e5ee549c20394736b4428bc59f460fa1548d1514676163dafc88'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('https://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s), please try manual install' % (dh, h)) if dh != h else open(os.path.join(ipp, pf), 'wb').write(by)注意两点:- URL 已从
http://升级为https://packagecontrol.io/,旧地址多数已失效 - 脚本末尾不加
sublime.reload_plugin('package_control'),新版会自动加载
Preferences → Package Control 菜单项出现,就说明成功。
网络受限时手动放 Package Control.sublime-package 到 Data/Installed Packages/
内网、代理拦截、DNS 污染都会让控制台脚本卡住或校验失败。这时别硬等,直接手动补位。
- 去 Package Control GitHub Releases 下载最新
.sublime-package文件(如Package Control.sublime-package) - 把它放进便携版目录下的
Data/Installed Packages/(不是根目录下的Installed Packages!) - 确保该路径真实存在:
Data/Installed Packages/→ 若不存在,逐层新建Data→Installed Packages - 重启 Sublime,检查
Preferences菜单是否出现Package Control子项
Ctrl+Shift+P → Install Package 无响应,大概率是 Data/Packages/ 下有损坏的缓存,删掉 Data/Packages/User/Package Control.cache 再试。
验证插件是否真被便携化:改完设置要查 Packages/User/ 路径
很多人装完 Package Control 就以为万事大吉,结果换台电脑一跑,插件全没了——因为没确认插件实际装在哪。
打开 Preferences → Browse Packages…,看弹出的路径是不是以你当前便携目录为根,形如:
D:\tools\Sublime Text 3\Data\Packages而不是
C:\Users\xxx\AppData\Roaming\Sublime Text 3\Packages。只有前者才代表真正便携。
后续所有插件配置(比如 LSP.sublime-settings、SublimeLinter.sublime-settings)都必须落在 Data/Packages/User/ 下,且文件名严格匹配插件名(含空格和连字符)。少一个字母、多一个下划线,配置就不生效。最稳妥的方式是始终通过 Preferences → Package Settings → [插件名] → Settings 打开,它自动定位到正确的用户配置文件。











