必须通过help → about sublime text查看真实build号（如build 4169）确认版本，覆盖升级仅官网安装包安全，便携版须保留data文件夹，插件需适配python 3.8否则报错。
覆盖升级前必须确认真实 Build 号
别信安装包名、任务栏图标或启动页右下角小字——那些都可能滞后或伪造。唯一可信的是 Help → About Sublime Text（macOS 是 Sublime Text → About）弹窗第一行显示的 Build 4169 这类编号。你当前用的到底是 ST3 还是 ST4，插件是否兼容，全看这个数字。如果弹窗没出现、卡死或显示异常，说明已有底层冲突，此时强行覆盖只会让问题更难排查。
Windows/macOS 官网安装包覆盖是安全的
只要你用的是官网下载的正式安装包（sublime_text_build_4169_x64_setup.exe 或 Sublime Text Build 4169.dmg），直接运行并按提示完成安装即可。它会自动保留 Data 文件夹（含 Packages/User/、Installed Packages/、缓存等），不会清空你的设置和插件。
但注意以下三点：
- 安装时勾选「Add to explorer context menu」和「Associate .txt files」，否则右键菜单和文件关联会丢失
- macOS 拖拽替换时，系统提示“替换”就点确定，不要选“保留两者”——那会留下两个同名 App，容易误启旧版
- Linux 用户不能用
apt-get install sublime-text覆盖旧版（尤其 UOS 等国产系统），因为 apt 源默认指向 ST3；必须手动下载 tarball 解压，并重建subl软链接：sudo ln -sf /opt/sublime_text/subl /usr/local/bin/subl
便携版升级只换可执行文件，Data 绝对不能动
便携版所有用户数据都在 Data 文件夹里，包括插件、设置、缓存、索引。升级时：
- 先完整备份整个
Data目录（不是只复制User/） - 解压新版便携包后，仅替换根目录下的
sublime_text.exe（Windows）、Sublime Text（macOS）或对应二进制（Linux） - 绝对不要把新版便携包整个解压覆盖旧目录——
Data会被清空，插件和设置全丢 - 验证方式：启动后打开 Preferences → Browse Packages…，确认
User/和Installed Packages/内容仍在，且 Help → About 显示目标 Build 号
覆盖后插件报错，大概率是 Python 版本不兼容
ST4 强制使用 Python 3.8 运行时，而 ST3 插件很多基于 Python 2.7。典型错误是控制台（Ctrl+`）里出现：ImportError: No module named 'urllib2' 或 AttributeError: 'module' object has no attribute 'set_timeout_async'。
这不是覆盖操作失败，而是插件本身未适配：
- 用
Ctrl+Shift+P输入Package Control: List Packages查出所有已装插件 - 逐个运行
Package Control: Upgrade Package，看是否能更新到 ST4 兼容版本 - 仍报错的插件，去其 GitHub 主页查最新 release 时间——2021 年 5 月之后发布的才大概率支持 ST4
- 别手动复制
Installed Packages/下的.sublime-package文件到 ST4，新版加载器可能拒绝解析旧格式
真正容易被忽略的是：许可证通用、配置结构兼容，但插件生态不是自动演进的。哪怕 sublime.version() 返回 4169，只要插件调用了已被移除的 API，它就会静默失效——得靠控制台里的红色报错来揪出来。
