必须分清.sublime-package文件与源码文件夹：前者放installed packages/，后者整体放packages/根目录且命名严格匹配官方名；配置迁移仅认packages/user目录，漏文件或路径错误将导致功能丢失。
Sublime 插件和配置文件不能靠“拖进去就完事”，必须分清 .sublime-package 和源码文件夹两种类型，且 Packages/ 与 Installed Packages/ 绝对不能混放；配置迁移只认 Packages/User 目录，漏一个文件就丢功能。
怎么判断插件是 .sublime-package 还是源码文件夹？
拿到别人给的插件包，先看文件结构：
- 如果是一个单独的
Emmet.sublime-package文件（后缀明确、大小几十到几百 KB），那就是 Package Control 缓存格式，走Installed Packages/ - 如果解压后看到
emmet-sublime/这样的文件夹，里面含emmet.py或main.py，就是源码格式，必须放Packages/根目录 - 如果只有
Package Control.sublime-package但没其他文件，说明对方只给了管理器本身，不是插件
混放会导致插件不加载，甚至控制台报 reloading plugin XXX failed —— Sublime 不会提示你放错了，它直接跳过。
手动导入插件时路径和命名必须精确到字节
源码插件放进 Packages/ 后，名字不对等于没装：
- 进
Preferences → Browse Packages…，确认你操作的是真实Packages/目录（不是Installed Packages/） - 把插件文件夹重命名为官方仓库名，比如 GitHub 上地址是
https://github.com/braver/SideBarEnhancements，文件夹名就必须是SideBarEnhancements，大小写不能错 - 删掉所有中间层，例如
SideBarEnhancements-master/SideBarEnhancements/→ 只留最内层SideBarEnhancements/ - 整个文件夹拖进
Packages/根目录，不能嵌套在子文件夹里
重启后按 Ctrl+Shift+P 搜 Side Bar: …，能出来命令才说明加载成功；否则查控制台有没有 import error 或 no module named。
Packages/User 目录才是配置迁移的唯一有效路径
快捷键、字体、缩进、插件开关状态全存在这里，复制错地方等于白干：
- Windows 路径：
%APPDATA%\Sublime Text\Packages\User - macOS 路径：
~/Library/Application Support/Sublime Text/Packages/User - Linux 路径：
~/.config/sublime-text/Packages/User - 必须关掉 Sublime 再复制，否则它可能自动生成默认
Preferences.sublime-settings覆盖你的备份 - 别只拷
Preferences.sublime-settings：漏掉Package Control.sublime-settings，插件不会自动启用；漏掉Preferences.sublime-keymap，F5/F6 快捷键全失效
配色方案要额外处理：color_scheme 设置项只是路径引用，真正的 .tmTheme 或 .sublime-color-scheme 文件得一并拷过去，否则界面还是灰白底。
为什么重启后插件没反应或配置不生效？
常见静默失败原因不是代码问题，而是环境细节被忽略：
-
ignored_packages列表里有插件名（比如"SideBarEnhancements"），它会被强制禁用，得手动删掉 - 主题或配色路径写错：比如
"color_scheme": "Packages/Dracula/Dracula.tmTheme"，但实际文件夹叫dracula-color-scheme，大小写或短横不匹配就无效 - 缓存没清干净：Sublime 有些 UI 元素（如侧边栏背景、标签页高度）必须完全退出再启动才刷新，最小化不算退出
- 便携版用户注意：
Data\Packages\User才是它的配置目录，不是系统级Packages/User
真正卡住人的从来不是“会不会装”，而是 Packages/ 和 Installed Packages/ 的分工、User 目录的完整性和路径大小写的零容忍——这些细节一旦出错，Sublime 就安静地退回默认状态，连个错误提示都不给。
