覆盖升级不丢数据的要点

5.21 是老版本线的收尾

本站资源对应 5.21 版本线——目前这是老版本线的最新版和收尾版。如果你看到的「更新」通知里指向 WebCatX 6.x 的下载链接，那是另一条版本线，包名不同、不是直接的版本升级——两版可以共存安装在同一台手机上，互不干扰。

下面说的升级要点，适用于同一条版本线内的小版本更新（比如从 5.20 升到 5.21）。

升级的正确姿势

第一步：升级前先备份所有工程

这是最重要的一步。升级前把所有工程导出 ZIP 备份到电脑或网盘——万一升级过程中出现意外（系统 Bug、安装包损坏），有备份就不怕丢。备份方法见 工程导出备份。

第二步：拿到新版 APK

• 本站网盘里如果有更新的 5.21.x 小版本，直接下载新版本 APK
• 别从陌生来源下载——WebCat 的 APK 渠道本身比较分散，来路不明的包可能被改过

第三步：覆盖安装

直接用新 APK 安装，不要先卸载旧版——这是安卓标准升级流程。覆盖安装的好处：

• 应用数据目录里的工程文件会保留
• 你的设置、主题偏好不会丢
• 比卸载重装省事得多

第四步：升级后验证

安装完成打开 WebCat，快速核对三件事：

1. 之前的工程列表都还在
2. 随便打开一个工程、点运行预览，确认正常
3. 设置里的 PHP 开关位置没变（有些大版本更新会调整设置布局）

没问题就升级成功了。

升级过程中不要做的事

❌ 不要先卸载旧版再装新的

卸载会删除应用数据目录——里面存的所有工程文件、设置、备份都会消失。卸载是给「不想用了才删」用的，不是升级用的。

❌ 不要手动清除应用数据

有些教程可能建议「升级前清除缓存/清除数据」——千万别清除数据。清除数据等同于卸载后重装，工程文件全部清空。清缓存可以（设置 → 应用 → WebCat → 清除缓存），清数据不行。

❌ 不要在升级中强行重启手机

覆盖安装过程中系统在替换文件，如果中途断电或重启，可能导致安装不完整——应用会处于半残状态（有的功能能用、有的不能）。如果真的卡住了，等一会儿让系统自己完成安装，实在不行再考虑卸载重装（但之前必须有备份）。

❌ 不要从不同版本线混装

5.21 和 WebCatX 6.x 包名不同，不会触发覆盖安装——系统会提示「已安装另一个版本」。这时候两者应该并存安装，不要试图强行覆盖。

真出事了怎么办

升级后如果 WebCat 打不开、工程全不见了，先别慌，先试这两个操作：

1. 强制停止再重新打开：设置 → 应用 → WebCat → 强制停止，然后重新打开
2. 重启手机：某些版本升级后需要系统重启才能正确加载

都不行的话，只能卸载重装——但前提是你已经在升级前做了完整的 ZIP 备份，卸载后用新 APK 安装，通过 ZIP 导入功能把之前备份的工程导回来。