唯一确认sublime text真实版本的方式是通过菜单栏的about sublime text查看build编号；st4需彻底卸载st3后重装，因架构重构且不兼容st3配置；便携版升级仅替换可执行文件并保留data目录；升级后需检查编码错误并手动处理非utf-8文件。
怎么看自己到底用的是哪个版本
别信任务栏图标、启动页右下角小字、安装包文件名——这些全不可靠。唯一能确认真实版本的方式是打开软件后，macOS 点顶部菜单 Sublime Text → About Sublime Text，Windows/Linux 点 Help → About Sublime Text，弹窗第一行显示的 Build 4192 这类编号才是真版本号。官网更新日志、插件兼容性说明、报错排查，全部认这个 build 号。
ST3 升级到 ST4 必须重装，不是覆盖安装
ST4 是 Python 3.8 运行时 + 架构级重构，和 ST3 共享配置目录会直接崩溃。常见现象包括：ImportError: No module named 'urllib2'、命令面板卡死、Preferences → Package Settings 里插件菜单消失、启动黑屏或侧边栏不显示已打开文件。
- Windows：先卸载 ST3（控制面板 → 卸载程序），再从
sublimetext.com/4下载最新sublime_text_build_4192_x64_setup.exe安装 - macOS：删掉
/Applications/Sublime Text.app，下载Sublime Text Build 4192.dmg拖入 Applications - Linux：删旧软链接，解压新 tarball 到
/opt/sublime_text，重建链接：sudo ln -sf /opt/sublime_text/subl /usr/local/bin/subl
便携版升级只换可执行文件，Data 文件夹必须原样保留
便携版所有插件、设置、缓存全在 Data 文件夹里。升级时最容易踩的坑是：解压新版压缩包覆盖整个旧目录——这会清空 Data，导致插件全丢。
- 升级前务必完整备份整个
Data目录 - 仅替换根目录下的
sublime_text.exe（Windows）、Sublime Text可执行文件（macOS）或对应二进制（Linux） - 验证是否成功：启动后检查
Help → About Sublime Text版本号，再打开Preferences → Browse Packages…，确认User/和Installed Packages/内容仍在
升级后第一个要检查的是编码错误
ST4 默认强制 UTF-8 解码，而 ST3 对非 UTF-8 文件更宽容。升级后如果打开某些文件报错：UnicodeDecodeError: 'utf-8' codec can't decode byte，说明文件用了 GBK 或其他编码。
- 临时解决：右键文件 →
Reopen with Encoding → GBK（或其他对应编码） - 长期建议：用插件如
ConvertToUTF8批量转存为 UTF-8 - 注意：不要把
"encoding": "GBK"这类设置写进全局Preferences.sublime-settings，否则可能干扰其他项目
