唯一可靠方式是打开软件后通过菜单查看真实build号：macos选sublime text→about sublime text，windows/linux选help→about sublime text，弹窗首行显示的build号（如build 4162）才是官网更新日志与本地环境的唯一对应依据。
怎么确认自己当前用的是哪个Sublime Text版本
别信启动页右下角的小字、任务管理器里显示的进程名，甚至安装包文件名都可能滞后。唯一可靠的方式是打开软件后：macOS 点顶部菜单 Sublime Text → About Sublime Text，Windows/Linux 点 Help → About Sublime Text，弹窗第一行显示的就是真实 build 号（如 Build 4162）。这个号才是官网更新日志和你本地环境的唯一对应依据——升级前不核对它，后面所有操作都可能白忙。
自动更新失败时为什么不能反复点“Check for Updates”
点击 Help → Check for Updates 没反应，或提示 “already up to date” 但你知道官网已发布新 build，大概率是网络策略拦截或代理干扰。此时反复重试只会卡在旧状态，不会触发真实下载。
- 直接去官网手动下载：https://www.php.cn/link/ee80e0a74aac64251238cecee2b066ca，页面底部有明确的
Download按钮 -
Windows用户下载.exe安装包，运行后默认勾选Replace existing installation，会覆盖旧程序但保留Data文件夹（便携版）或%APPDATA%\Sublime Text\Packages（常规版） -
macOS用户拖拽新Sublime Text.app到/Applications，系统提示替换时选“替换”即可 -
Linux用户注意区分.deb（Debian/Ubuntu）和.rpm（Fedora/RHEL），用sudo dpkg -i或sudo rpm -Uvh安装，不需卸载旧版
便携版升级后插件全没了，错在哪
便携版升级最常踩的坑：只替换了 sublime_text.exe（或 macOS 的可执行文件），却没确认 Data 文件夹位置是否被软件自动迁移或重置。便携版的全部用户数据（包括 Packages、Settings、Cache）全存在 Data 目录下。
- 升级前必须先备份整个
Data文件夹（注意大小写：D大写，ata小写） - 解压新版便携包后，仅替换根目录下的可执行文件和资源文件（如
sublime_text.exe、lib目录） -
Data文件夹必须原样保留、不可覆盖——哪怕新版包里自带一个空的Data，也别用它替换
只备份 Packages/User 能不能保住所有设置
能保住大部分个性化配置（字体、缩进、快捷键、构建系统、插件开关状态），但不足以还原完整功能。因为 Packages/User 不含插件源码，也不含配色方案文件本身。
- 必须一并复制：
Packages/User整个文件夹（必选） -
Packages/下所有非User的子目录（如GitGutter/、EmmyLua/、Dracula Color Scheme/） - 配色方案文件：
"color_scheme": "Packages/Dracula/Dracula.tmTheme"这行只是路径引用，真正起作用的是那个.tmTheme或.sublime-color-scheme文件，得按路径去找、去拷 - 便携版用户跳过路径判断——直接复制整个
Data文件夹最省事
关掉 Sublime Text 再动手，否则进程锁住目录会导致配置重置、文件损坏；托盘图标还在 ≠ 进程已退出，务必确认 subl 或 sublime_text 进程彻底消失。
