如何将Sublime Text进行版本降级或升级操作？

本文共计880个文字，预计阅读时间需要4分钟。

Sublime Text 升级或降级方法——仅重装

所谓版本切换，本质是卸载旧版、安装指定的新版 build，并手动迁移配置和插件。直接替换或覆盖安装行为会导致插件失效、设置丢失、甚至启动黑屏。

具体步骤如下：

怎么确认当前真实版本号

别信任务栏图标、启动页右下角小字、或安装包文件名。唯一可靠方式是打开软件后：

• macOS：顶部菜单 Sublime Text → About Sublime Text
• Windows/Linux：Help → About Sublime Text

弹窗第一行显示的 Build 4169 这类编号才是真实版本号，官网更新日志、插件兼容性说明、问题排查都只认这个。

升级到 ST4 必须手动重装，不是覆盖安装

ST4 是架构级重构，与 ST3 共享配置目录会导致崩溃。常见错误现象包括：

• ImportError: No module named 'urllib2'（Python 2 遗留代码）
• 命令面板 Ctrl+Shift+P 卡死或无响应
• Preferences → Package Settings 里插件菜单消失
• 启动后黑屏，或侧边栏不显示已打开文件（side_bar_show_open_files 默认为 false）

实操路径：

• Windows：先卸载 ST3，再从 sublimetext.com/4 下载最新 sublime_text_build_4169_x64_setup.exe 安装
• macOS：删除 /Applications/Sublime Text.app，下载 Sublime Text Build 4169.dmg 拖入 Applications
• Linux：删除旧 subl 软链接，解压新 tarball 到 /opt/sublime_text，重建链接：sudo ln -sf /opt/sublime_text/subl /usr/local/bin/subl

便携版升级只换程序，Data 文件夹必须保留

便携版所有用户数据（插件、设置、缓存）全在 Data 文件夹里。升级时：

• 务必先完整备份整个 Data 目录
• 仅替换根目录下的 sublime_text.exe（Windows）、Sublime Text 可执行文件（macOS）或对应二进制（Linux）
• 不要解压新版便携包覆盖整个旧目录——否则 Data 会被清空

验证是否成功：启动后检查 Help → About Sublime Text 版本号，再打开 Preferences → Browse Packages…，确认 User/ 和 Installed Packages/ 内容仍在。

降级回 ST3 唯一安全方式是彻底清理 + 重装旧 build

ST4 安装后会写入新的注册表项（Windows）、plist（macOS）或配置路径（Linux），残留文件可能干扰 ST3 启动。降级前必须：

• 完全卸载 ST4（含清理 %APPDATA%\Sublime Text 4、~/Library/Application Support/Sublime Text 4 等目录）
• 从官网历史页下载对应旧 build 的安装包（如 sublime_text_build_3211_x64_setup.exe）
• 安装时确保不勾选“Add to explorer context menu”等可能冲突的选项（尤其当 ST4 注册表未清干净时）

最易被忽略的一点：ST4 的 Package Control 插件本身不兼容 ST3，降级后必须手动删除 Installed Packages/Package Control.sublime-package，再用 ST3 兼容版重装——否则控制台会持续报错 AttributeError: module 'ssl' has no attribute 'PROTOCOL_TLS'。