必须确认Packages、Installed Packages及配色/构建系统真实路径,唯一可靠方式是启动Sublime Text后通过Preferences → Browse Packages…查看弹窗地址,并在控制台运行sublime.packages_path()和sublime.installed_packages_path()验证。

离线迁移前必须确认的三个真实路径
别靠记忆拼路径,不同系统、ST 版本(3/4)、便携版/常规版,Packages 和 Installed Packages 的物理位置完全不同。硬记 %APPDATA% 或 ~/Library/Application Support 极易出错——尤其 macOS 终端里空格必须写成 Application\ Support,Linux 还要区分 sublime-text-3 和 sublime-text-4。
最准做法永远是:启动 Sublime Text → Preferences → Browse Packages…,弹出窗口地址就是你要操作的真实位置。如果它指向 Data\Packages,说明你当前用的是便携版,别去翻 %APPDATA%;如果指向 %APPDATA%\Sublime Text\Packages,那才是常规版 ST4 的真实路径(注意带空格,不是 Sublime Text4)。
同时在控制台(Ctrl+`)运行:print(sublime.packages_path())print(sublime.installed_packages_path())
能直接输出两个目录的绝对路径,比手动拼更可靠。
.sublime-package 和解压文件夹不能混放同一目录
Sublime 对插件加载路径有硬性分工,放错位置就等于没装——它不会报错,只会沉默跳过。
-
.sublime-package文件(如Emmet.sublime-package)→ 必须直接丢进Installed Packages/目录,不解压、不改名、不嵌套子文件夹 - GitHub 下载 ZIP 解压后得到的文件夹(如
Emmet-master/)→ 必须整体复制进Packages/根目录,且文件夹名要和插件官方名完全一致(删掉-master,大小写敏感,PyV8不能写成pyv8) - 如果
Packages/下已有某插件解压目录(如Packages/GitGutter/),而Installed Packages/里还有GitGutter.sublime-package,优先保留解压版,删掉.sublime-package——因为解压版才是当前实际加载的
迁移后插件不生效?先查 ignored_packages 和语法作用域
命令面板搜不到、快捷键无反应、右键菜单空白,八成不是没装上,而是被 Sublime 主动屏蔽了。
打开 Preferences → Settings,看右侧用户配置里有没有 "ignored_packages" 字段。常见值如 ["Vintage", "Anaconda"],如果你刚放进去的插件叫 "Origami",而它也在这个列表里,就会被静默忽略。删掉对应项或整行注释掉,保存后必须重启 Sublime 才生效。
另外,很多插件只在特定语法下触发——比如 Vue Syntax Highlight 只响应 .vue 文件或 text.html.vue 作用域。打开纯 .html 文件时完全静默,这不是 bug,是设计如此。验证时务必用对应类型文件测试。
配色方案和构建系统必须连文件一起搬
Preferences.sublime-settings 里的 "color_scheme": "Packages/Dracula Color Scheme/Dracula.tmTheme" 只是一条路径引用,不是文件本身。真正起作用的是那个 .tmTheme 或新式的 .sublime-color-scheme 文件。
按路径去 Packages/ 下找对应文件夹,比如 Packages/Dracula Color Scheme/Dracula.tmTheme。如果目标文件夹里没有该文件,但有个 Dracula Color Scheme.sublime-package,就把后缀改成 .zip 解压,提取里面的主题文件。
同理,MyBuild.sublime-build 这类自定义构建系统,也必须从原 Packages/User/ 目录完整复制过去,光改设置项没用——Sublime 不会自动下载或生成它们。
最容易被忽略的是命名一致性:文件夹名、文件名、路径中的空格和大小写,Sublime 全部严格校验。ST4 尤其敏感,旧版 Package Control.sublime-package 在 ST4 上可能根本加载不了,得换新版。


















