sublime text便携版插件需严格置于data\packages\（源码）或data\installed packages\（.sublime-package），data文件夹须同级手动创建、大小写精确；package control须用新版python3脚本安装；st3/st4插件不兼容，验证以控制台日志和命令面板为准。
Sublime Text 便携版插件必须放对位置才能直接加载，错一个字符或一层目录都会失效。
便携版的 Data 目录必须严格存在且命名正确
官网下载的 sublime_text.exe 解压后只是普通安装版，不会自动便携。你得在同级目录手动新建一个名字**严格为 Data** 的空文件夹（大小写敏感，不能是 data 或 DATA）。启动后 Sublime 会自动生成 Data\Packages\ 和 Data\Installed Packages\。验证方式只有一种：菜单 → Preferences → Browse Packages…，路径必须显示为 xxx\Data\Packages。如果指向 %APPDATA% 或 ~/Library/...，说明 Data 文件夹建错了位置（比如建在子目录里）或者拼写错误。
.sublime-package 和源码文件夹不能混放进同一级 Packages
离线安装时最容易踩的坑是路径层级混乱：
- 如果是
GitGutter.sublime-package文件 → 直接丢进Data\Installed Packages\，不要解压，也不要放进Packages - 如果是从 GitHub 下载的
GitGutter-master.zip→ 解压出GitGutter文件夹（注意保留原始大小写），整个文件夹复制到Data\Packages\顶层，不能嵌套在子文件夹里，也不能重命名为GitGutter-master -
Data\Packages\下只允许出现插件文件夹，不能有zip、sublime-package或其他压缩包
Package Control 必须手动安装，且控制台代码已更新
便携版首次运行后，Package Control 不会自动出现。必须用 Python 3 兼容代码安装：
import urllib.request,os,hashlib; h = 'df21e130d211cfc94d9b0905775a7c0f1e3d39e33b79698005270310898eea76'; 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('http://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)
按 Ctrl+` 打开控制台，粘贴执行。成功后重启，再按 Ctrl+Shift+P 就能搜到 Package Control: Install Package。旧版安装脚本已失效，用错就白忙活。
多版本共存时 Packages 目录不共享
Sublime Text 3 和 4 的 Packages 目录完全独立。如果你同时装了 ST3 和 ST4 的便携版，它们各自的 Data\Packages 互不影响。但别试图把 ST3 的插件文件夹直接拷进 ST4 的 Packages —— 很多插件依赖不同 Python API，ST4 默认用 Python 3.3+，而 ST3 插件可能含 Python 2 语法，一加载就报 ImportError 或控制台静默失败。
真正麻烦的不是“怎么放”，而是“放完怎么确认它真在跑”。最可靠的验证动作只有两个：打开控制台看有没有 reloading plugin 日志，以及在命令面板里搜插件名看对应命令是否存在。其他都是障眼法。
