便携版Sublime必须在sublime_text.exe同级目录严格创建首字母大写的Data文件夹，否则配置写入系统路径；插件需按规则分放Installed Packages（.sublime-package压缩包）和Packages（解压后的同名文件夹）；离线安装Package Control须用ST4兼容脚本，且需彻底退出后重启验证。
便携版启动前必须建好严格命名的Data目录
没这个目录，Sublime 就当你是普通安装，所有配置和插件全写进系统路径。它不认data、DATA、MyData，只认紧挨着sublime_text.exe同级的那个首字母大写的Data文件夹。
常见错误是解压 ZIP 后直接双击运行——此时Data还没建，Sublime 已经在%APPDATA%里生成了默认配置；再补建Data也无效，得先关掉进程、删掉%APPDATA%\Sublime Text\整个目录，再建Data重来。
- Windows 下：解压到
D:\tools\SublimeText\，就在该目录下新建文件夹，名字必须是Data - macOS/Linux：同样在
sublime_text可执行文件所在目录新建Data - 启动后立刻验证：
Preferences → Browse Packages…，路径里必须含Data\Packages才算成功
Installed Packages和Packages别混放插件
离线装插件最常卡在这儿：.sublime-package 文件扔进了Packages，或 GitHub 下载的源码文件夹拖进了Installed Packages。Sublime 会彻底无视——不是报错，是静默跳过。
Installed Packages/只收压缩包：Package Control.sublime-package、Emmet.sublime-package这类结尾带.sublime-package的文件，直接丢进去，不要解压，不要改名，不要套子文件夹。
Packages/只收解压后的文件夹：从 GitHub 下载 ZIP，解压出来通常是BracketHighlighter-main/这种带-main或-master后缀的文件夹，得进到里面把真正含__init__.py的那层拎出来，重命名为BracketHighlighter（去掉后缀、去空格、大小写严格匹配官方名），再整体拖进Packages/根目录。
- 不确定路径？控制台输
print(sublime.packages_path())和print(sublime.installed_packages_path())，一眼看清真实位置 - 插件名大小写敏感：
VueSyntax≠vuesyntax≠vue-syntax - 放完必须彻底退出 Sublime（任务管理器里确认
sublime_text.exe进程消失），再重启才加载
Package Control 离线安装必须用 ST4 兼容脚本
ST4 启动后Ctrl+Shift+P搜不到Package Control: Install Package，说明它根本没加载。网上随便搜到的老版脚本在 ST4 上会静默失败，控制台可能只显示reloading plugin package_control.__init__然后停住。
必须用官网最新版：https://www.php.cn/link/2e5d5f65d3ef778b01366907d1f14445（注意 URL 中空格是 %20），或国内镜像https://www.php.cn/link/becebedf1c232fd3fcd44dcd8c0ef821。下载下来的文件大小应在 180–220 KB；小于 100 KB 是下载不全，直接删掉重试。
- 关闭 Sublime，进
Installed Packages/，删光所有含Package Control字样的文件 - 把新下载的
Package Control.sublime-package文件直接拖进Installed Packages/ - 重启后控制台出现
Package Control: Skipping update check才算真正就位
插件生效但命令不响应？先查ignored_packages和语法作用域
插件文件放对了、重启也做了，命令面板搜不到、快捷键按了没反应——八成是被 Sublime 主动屏蔽了，或者根本没触发对应语法环境。
打开Preferences → Settings，看右侧用户配置里有没有"ignored_packages"字段。如果刚装的插件名（比如"Emmet"）在里面，它就被静默禁用了，删掉那一项即可。
另一类情况是插件本身有作用域限制：比如Vue Syntax Highlight只响应.vue文件或text.html.vue作用域，你在纯.html里打开，它就完全不工作，连控制台都不报错。
- 验证作用域：打开目标文件，
Ctrl+Shift+P输入View: Show Scope Name，看底部状态栏显示的实际作用域 - 临时解除忽略：
Preferences → Package Settings → [插件名] → Settings – Default里找enabled或enable_on相关配置 - 便携版迁移时，
Data\Packages\User\才是你该同步的唯一配置目录，其他子目录自动生成，不用管
