Sublime Text 版本切换必须重装，不可覆盖安装；真实版本号需通过“About Sublime Text”查看Build编号；ST4与ST3不兼容，升级降级均需彻底卸载、清理配置并手动迁移Data文件夹。
Sublime Text 不能“升级”或“降级”——只有重装。所谓版本切换，本质是卸载旧版、安装指定 build 的新版，并手动迁移配置和插件。任何试图直接替换 sublime_text.exe 或覆盖安装的行为，都会导致插件失效、设置丢失、甚至启动黑屏。
怎么确认当前真实版本号
别信任务栏图标、启动页右下角小字、或安装包文件名。唯一可靠方式是打开软件后：
- 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'。
