sublime text 版本号以 build 号为准，通过 help → about sublime text（macos 为 sublime text → about）查看；自动更新依赖 update_check 为 true 且能连通官网；推荐覆盖安装保留配置；st4 升级后插件报错多因 python 2 不兼容，需升级或重装插件。
怎么快速确认当前 Sublime Text 版本号
打开 Sublime Text，点击菜单栏 Help → About Sublime Text，弹窗里第一行显示的就是完整版本号（如 Build 4162），这是唯一权威来源。macOS 用户注意：顶部菜单是 Sublime Text 菜单项，不是 Help；windows/linux 则统一在 Help 下。
别信启动页右下角小字、任务管理器进程名或安装包文件名——那些可能滞后或不准确。版本号本质是 build 号，不是“4.4”这类营销命名，官网更新日志也全按 build 号发布。
自动检查更新为什么有时不生效
Sublime Text 默认开启自动检测，但依赖两个前提：update_check 设置为 true，且软件能连通官网服务器（www.sublimetext.com）。国内部分网络环境会因 DNS 或防火墙导致超时静默失败，界面无提示，用户误以为“没更新”。
- 手动触发检查：菜单
Help→Check for Updates，比等启动弹窗更可靠 - 确认设置是否启用：打开
Preferences→Settings，右侧用户设置中必须有"update_check": true（注意英文逗号分隔） - 如果始终失败，说明网络路径不通，直接走手动下载更省时间
覆盖安装 vs 替换可执行文件：选哪个
绝大多数用户用「官网安装包覆盖安装」最安全——它会保留 Data 目录（含所有插件、配置、主题），且自动处理注册表（Windows）或 LaunchServices（macOS）。便携版（Portable）用户则必须用「替换可执行文件」方式，因为没安装器。
- Windows 正式版：运行新
sublime_text_setup.exe，勾选“Add to explorer context menu”等选项不影响旧配置 - macOS：拖拽新
Sublime Text.app到/Applications，系统会自动覆盖，~/Library/Application Support/Sublime Text不动 - 便携版：只换根目录下的
sublime_text.exe（Win）或sublime_text（Linux/macOS），Data文件夹绝不能删或覆盖
更新后插件打不开或报错怎么办
主程序升级后，部分插件（尤其是用 Python 2 编写的旧插件）可能因 Sublime Text 4 强制切换到 Python 3 运行时而失效，典型现象是命令面板搜不到插件命令，或控制台报 ImportError: No module named 'urllib2'。
- 先调出控制台：
Ctrl+`（Windows/Linux）或Cmd+`（macOS），看具体错误 - 更新插件本身：按
Ctrl+Shift+P输入Upgrade Package，选中问题插件升级 - 仍不行？查该插件 github 主页是否已声明兼容 ST4；没有就换替代品，比如
SideBarEnhancements已支持，但某些小众 fork 可能停滞
别忽略 Data/Packages 里残留的旧插件缓存，彻底解决有时需要手动删掉对应文件夹再重装。