游戏客户端架构 / 系统课时

错误信息怎样让玩家看得懂

错误信息怎样让玩家看得懂

文件不存在、JSON 解析失败、校验和不一致,对开发者很有用,但直接显示给玩家几乎没有帮助。本节建立一层错误翻译机制:底层保留精确诊断信息,界面只展示玩家能理解的结果、影响范围和下一步操作。

学习目标

  • 区分开发诊断错误与玩家可见提示
  • 把底层异常映射为稳定的用户错误类型
  • 为每类错误配置可执行且安全的恢复选项

先把技术错误收敛成玩家语义

玩家真正关心的通常只有三件事:发生了什么、当前存档还能不能用、接下来能做什么。因此不要让 UI 直接依赖 IOException、JsonException 或某个序列化库的错误文本,而应先收敛成稳定的业务错误类型。

例如,FileNotFoundException 可以归入“存档不存在”,解析失败与校验和不一致可以归入“存档损坏”,版本号过高可以归入“版本不兼容”。底层日志仍记录原始异常、文件路径和堆栈,玩家界面只消费业务错误。

存档错误从底层异常到玩家提示的转换链

用映射层统一提示和操作

下面的 C# 示例把底层错误枚举映射为玩家提示。UI 不需要知道文件系统或解析器细节,只需渲染 PlayerNotice。

csharp
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)}]");
        }
    }
}

预期输出:

text
ChecksumMismatch: 这个存档可能已损坏。 [载入备份, 选择其他槽位]
UnsupportedVersion: 这个存档来自不兼容的游戏版本。 [检查更新, 返回主菜单]
DiskFull: 存储空间不足,无法保存进度。 [释放空间, 重试保存]

这样做还有一个工程收益:底层实现从 JSON 换成二进制格式时,只要业务错误类型保持稳定,UI 文案和交互无需跟着重写。

提示必须指向真实可用的恢复动作

恢复按钮不能只是“好”“确定”。如果系统检测到备份可用,才显示“载入备份”;没有其他槽位时就不要显示“选择其他槽位”;磁盘空间不足时,“重试保存”应与“释放空间后再试”的状态联动。

对可能丢失数据的操作要显式区分。例如“创建新存档”可能覆盖当前槽位,就必须二次确认,并说明覆盖对象。相反,“重试读取”属于无破坏操作,不需要额外制造确认步骤。

给开发者的信息不要泄漏给玩家

开发日志可以包含内部路径、异常类型、堆栈、校验值和版本号,因为这些信息用于定位问题;玩家提示则不应暴露本地绝对路径、序列化细节或未经处理的异常文本。

更稳妥的做法是给每次失败生成一个短错误编号,例如 SAVE-READ-03。界面可以显示编号,日志记录编号对应的完整诊断信息。这样玩家联系客服时有可引用的线索,又不会看到难以理解的底层细节。

可读的错误信息不是“把异常翻译成中文”,而是把技术失败转换成玩家能理解的状态 + 当前影响 + 可执行的下一步。只要 UI 只依赖稳定的业务错误层,底层实现变化也不会把技术细节重新泄漏到玩家面前。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

错误信息怎样让玩家看得懂

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通