升级前，先留一条退路

记录当前状态

保存当前程序版本、可用配置和你手动修改的内容。远程配置发生更新时也可能改变行为，排查时需要同时考虑两者。

阅读跨越版本的说明

正式版与预发布版用途不同。选择正式版前查看发布记录；跨版本时还要阅读迁移指南与废弃字段说明。

先检查再运行

命令行环境可以使用目标版本运行检查。语法正确不等于服务器可用，检查通过后仍需测试实际连接。

sing-box check -c config.json

逐项验证与恢复

1. 验证配置是否能启动。
2. 验证 DNS、节点选择与常用应用。
3. 确认符合预期后保留新版本。
4. 如遇问题，恢复成对保存的旧版本与旧配置，再根据日志定位。