Package Control命令面板搜不到说明其未加载成功，需先验证sublime.version()确认ST版本，检查installed_packages_path()下是否存在Package Control.sublime-package，并清除旧包后重装官方脚本。
Package Control命令面板搜不到
说明它根本没加载进 Sublime 运行时，不是“装了没反应”，而是压根没进来。先别重装，快速验证三件事：
按 Ctrl+` 打开控制台，输入 sublime.version() 看返回值：4xxx 是 ST4，3xxx 是 ST3；版本错配会导致脚本静默失败
再输 sublime.installed_packages_path()，去文件系统里打开该路径下的 Installed Packages/ 目录，确认是否存在 Package Control.sublime-package
如果文件存在但命令仍不出现，大概率是残留旧包干扰：删掉 Installed Packages/ 下所有含 Package Control 字样的文件（包括 Package Control (old).sublime-package），再重跑官网最新脚本
注意：Packages/ 目录 ≠ Installed Packages/ 目录——把 .sublime-package 文件丢进 Packages/，Sublime 会彻底无视它
同步后插件菜单变灰或快捷键失效
这是典型缓存路径错乱导致的静默拒绝加载，不是配置没同步成功，而是 Sublime 检测到本地路径与缓存不一致。
必须只同步 Packages/User/ 目录，绝不能同步整个 Packages/ 或 Data/
同步内容仅限三类：*.sublime-settings（如 Preferences.sublime-settings）、平台专属 *.sublime-keymap（Default (Windows).sublime-keymap 和 Default (OSX).sublime-keymap 必须分开保留）、*.sublime-snippet
Windows 和 macOS 的快捷键文件名不同，混着同步直接失效
符号链接创建前务必退出 Sublime Text（包括后台进程），否则链接会指向空目录或内容不同步
云盘推荐 Dropbox 或坚果云；iCloud 同步 ~/Library/ 不稳定，OneDrive 对 %APPDATA% 有路径限制
控制台报 ImportError: No module named 'package_control'
这不是网络问题，是 Package Control 初始化失败，根源在缓存和路径错位。
错误常出现在硬拷整个 Packages/ 后：缓存文件（如 Package Control.cache、Session.sublime_session）被跨平台拖过去，Python 环境或换行符（CRLF/LF）差异触发校验失败
解决方式不是修缓存，而是清源：
关闭 Sublime 并确认进程已退出（Windows 任务管理器查 subl.exe，macOS killall sublime_text，Linux pkill -f "subl"）
删除 Packages/ 下除 User/ 外的所有子目录（如 Emmet/、SideBarEnhancements/）
保留 Installed Packages/ 中的 .sublime-package 文件，让 Package Control 在下次启动时重新解压并重建缓存
重启后若仍报错，检查 Preferences → Settings – User 中是否误写了 "ignored_packages"，且把 "Package Control" 加进去了
代码片段按 Tab 不触发，但 Ctrl+Shift+P 能搜到
这是 XML 解析静默跳过，常见于 scope 写错、换行符损坏或文件编码异常，不是同步丢失。*.sublime-snippet 文件必须放在 Packages/User/ 下，且文件名不能含空格或中文，扩展名必须是全小写 .sublime-snippet
用文本编辑器打开 snippet 文件，确认根节点为 source.python 不能写成 python）
检查换行符：Windows 用 CRLF，macOS/Linux 用 LF；混用会导致解析中断，Sublime 不报错也不加载
文件编码必须是 UTF-8 无 BOM；带 BOM 的文件在某些版本中会被跳过
改完保存后，必须彻底退出 Sublime 再重启——仅关闭窗口不会重载 snippet 表
同步真正难的不是操作步骤，是克制住“把整个 Packages 目录拖进云盘”的冲动。一旦跨出 Packages/User/ 这个边界，后续所有报错都只是症状，不是病因。
