Sublime Text插件升级失败后卡死闪退，主因是Packages目录下残留.tmp文件夹、upgrade_或pending_临时文件，以及ignored_packages自动屏蔽插件；需删除这些残留、清空Cache目录并重启。
插件升级中途失败后残留的半解压文件或损坏的 .sublime-package，是 Sublime Text 启动卡死、闪退或控制台刷屏报错的最常见原因——不是插件本身有问题，而是 Package Control 在下次启动时试图续传或校验这些“烂摊子”，直接阻塞主进程。
检查并删除 Packages 目录下的残留临时文件
升级中断后，Package Control 会在 Packages/ 目录下留下不完整的状态痕迹，这些文件会持续干扰后续加载流程。
- 通过
Preferences → Browse Packages…打开用户插件目录 - 删除所有以
.tmp结尾的文件夹（如Emmet.tmp） - 删除名称含
upgrade_或pending_的文件（如upgrade_GitGutter.sublime-package） - 检查
Installed Packages/目录：若存在同名的XXX.sublime-package和XXX/文件夹（例如Emmet.sublime-package和Emmet/），删掉.sublime-package文件，只保留解压版（2026年7月起 Sublime Text 4 默认优先加载解压目录）
确认插件是否被自动加入 ignored_packages
Sublime 启动时发现插件校验失败（比如 plugin.py 缺失或哈希不匹配），会静默将其写入 ignored_packages 列表，导致插件彻底不加载——你既看不到错误，也搜不到命令，但控制台里其实有线索。
- 按
Ctrl+Shift+P输入并执行Preferences: Package Control - 在控制台输出中搜索
ignored_packages，看目标插件名（如"Emmet"）是否在里面 - 若存在，打开
Preferences → Settings – User，找到"ignored_packages"数组，把对应插件名删掉（注意 JSON 格式，逗号不能多也不能少） - 保存后必须重启 Sublime Text，仅重载设置无效
强制刷新插件注册表并清理缓存
损坏的缓存会让 Sublime 错误地认为某个插件“已加载成功”，实际却跳过了初始化；或者反复尝试加载一个根本不存在的模块路径。
- 关闭 Sublime Text
- 进入用户数据目录：
- Windows：%APPDATA%\Sublime Text\Cache
- macOS：~/Library/Caches/Sublime Text/
- Linux：~/.cache/sublime-text/ - 删除整个
Cache/目录（不是里面的子文件夹，是整个文件夹） - 重启 Sublime，它会在首次启动时重建干净缓存
- 如果问题仍存在，可在控制台执行
sublime.cache_path()获取当前缓存路径，再手动清空
用安全模式快速验证是否插件引发启动失败
别猜，直接隔离。安全模式不加载任何插件、不读取用户设置，能帮你 10 秒内确认问题是否出在插件生态上。
- Windows/Linux：关闭 Sublime，按住
Shift键再双击图标启动
macOS：终端执行subl --safe-mode - 若能正常启动，说明确实是插件相关问题（不是系统权限、VC++ 运行库或 GPU 驱动等底层问题）
- 此时不要急着启用插件，先做前面三步清理——多数情况下清理完就能直接恢复正常启动
- 如果清理后仍无法启动，再考虑逐个启用插件排查，或检查控制台是否有
ImportError类报错指向具体插件
真正麻烦的从来不是“哪个插件坏了”，而是“坏了一半的插件还赖在那儿假装自己很完整”。删干净、清缓存、重启，比修配置快得多；而忽略 ignored_packages 这个隐藏开关，是 80% 插件失效问题被拖长的关键盲点。
