游戏客户端架构 / 系统课时
错误信息怎样让玩家看得懂
错误信息怎样让玩家看得懂
文件不存在、JSON 解析失败、校验和不一致,对开发者很有用,但直接显示给玩家几乎没有帮助。本节建立一层错误翻译机制:底层保留精确诊断信息,界面只展示玩家能理解的结果、影响范围和下一步操作。
学习目标
- 区分开发诊断错误与玩家可见提示
- 把底层异常映射为稳定的用户错误类型
- 为每类错误配置可执行且安全的恢复选项
先把技术错误收敛成玩家语义
玩家真正关心的通常只有三件事:发生了什么、当前存档还能不能用、接下来能做什么。因此不要让 UI 直接依赖 IOException、JsonException 或某个序列化库的错误文本,而应先收敛成稳定的业务错误类型。
例如,FileNotFoundException 可以归入“存档不存在”,解析失败与校验和不一致可以归入“存档损坏”,版本号过高可以归入“版本不兼容”。底层日志仍记录原始异常、文件路径和堆栈,玩家界面只消费业务错误。

用映射层统一提示和操作
下面的 C# 示例把底层错误枚举映射为玩家提示。UI 不需要知道文件系统或解析器细节,只需渲染 PlayerNotice。
using System;
enum SaveError
{
FileMissing,
PermissionDenied,
ParseFailed,
ChecksumMismatch,
UnsupportedVersion,
DiskFull
}
record PlayerNotice(string Message, string[] Actions);
class Program
{
static PlayerNotice ToPlayerNotice(SaveError error) => error switch
{
SaveError.FileMissing =>
new("没有找到这个存档。", new[] { "选择其他槽位", "创建新存档" }),
SaveError.PermissionDenied =>
new("当前无法读取存档文件。", new[] { "重试", "返回主菜单" }),
SaveError.ParseFailed or SaveError.ChecksumMismatch =>
new("这个存档可能已损坏。", new[] { "载入备份", "选择其他槽位" }),
SaveError.UnsupportedVersion =>
new("这个存档来自不兼容的游戏版本。", new[] { "检查更新", "返回主菜单" }),
SaveError.DiskFull =>
new("存储空间不足,无法保存进度。", new[] { "释放空间", "重试保存" }),
_ => new("存档操作失败。", new[] { "重试" })
};
static void Main()
{
foreach (var error in new[] {
SaveError.ChecksumMismatch,
SaveError.UnsupportedVersion,
SaveError.DiskFull
})
{
var notice = ToPlayerNotice(error);
Console.WriteLine($"{error}: {notice.Message} [{string.Join(", ", notice.Actions)}]");
}
}
}预期输出:
ChecksumMismatch: 这个存档可能已损坏。 [载入备份, 选择其他槽位]
UnsupportedVersion: 这个存档来自不兼容的游戏版本。 [检查更新, 返回主菜单]
DiskFull: 存储空间不足,无法保存进度。 [释放空间, 重试保存]这样做还有一个工程收益:底层实现从 JSON 换成二进制格式时,只要业务错误类型保持稳定,UI 文案和交互无需跟着重写。
提示必须指向真实可用的恢复动作
恢复按钮不能只是“好”“确定”。如果系统检测到备份可用,才显示“载入备份”;没有其他槽位时就不要显示“选择其他槽位”;磁盘空间不足时,“重试保存”应与“释放空间后再试”的状态联动。
对可能丢失数据的操作要显式区分。例如“创建新存档”可能覆盖当前槽位,就必须二次确认,并说明覆盖对象。相反,“重试读取”属于无破坏操作,不需要额外制造确认步骤。
给开发者的信息不要泄漏给玩家
开发日志可以包含内部路径、异常类型、堆栈、校验值和版本号,因为这些信息用于定位问题;玩家提示则不应暴露本地绝对路径、序列化细节或未经处理的异常文本。
更稳妥的做法是给每次失败生成一个短错误编号,例如 SAVE-READ-03。界面可以显示编号,日志记录编号对应的完整诊断信息。这样玩家联系客服时有可引用的线索,又不会看到难以理解的底层细节。
可读的错误信息不是“把异常翻译成中文”,而是把技术失败转换成玩家能理解的状态 + 当前影响 + 可执行的下一步。只要 UI 只依赖稳定的业务错误层,底层实现变化也不会把技术细节重新泄漏到玩家面前。