《后端架构设计·架构基础与边界》附录 B Go/Java 对照速查
以 arch-lab 订单系统为例,把同一套值对象、端口、密封结果、状态机与补偿逻辑分别用 Go 1.26 和 Java 21 实现并真实运行,对照错误处理、可空性、接口闭合性以及 goroutine 与虚拟线程的并发模型差异,并给出双向迁移检查表与常见误译。
tag
以 arch-lab 订单系统为例,把同一套值对象、端口、密封结果、状态机与补偿逻辑分别用 Go 1.26 和 Java 21 实现并真实运行,对照错误处理、可空性、接口闭合性以及 goroutine 与虚拟线程的并发模型差异,并给出双向迁移检查表与常见误译。
把弱网打开、进程回收恢复、支付回调重复、包体超限四个质量属性场景转成可评分风险条目,用影响、概率、发现难度三维打分并排序,给出阈值、结论判定与固定输出格式,附一次基线评审记录、风险关闭过程,以及清单如何进入下一轮迭代并转化为可执行的发布条件。
收口卷一的模块依赖:把各章实验整理成带层级的模块清单,构建依赖图、Kahn 拓扑排序、回路检测与方向校验,输出可直接写入评审记录的文本。附卷一真实依赖图的结论,说明 summary 组合根为什么允许向下穿透多层,以及依赖图与架构图之间仍缺的那部分证据。
pebble/config/ 的字段字典与 schema:economy.json 与 ch00_budget.json 每个字段的类型、含义与取值范围,一份可机读的 schema(D 层),以及一段真跑的校验脚本(S 层)。核心纪律是 config 里禁浮点——增长率写整数比、系数写整数百分比,随机数必须可播种。
卷一的复现手册:本机实测环境(Python 3.14 + numpy/pandas、Node 26 原生 TypeScript、无 matplotlib、无 tsc/npm)、bastion 完整目录结构、全部实跑命令、跨语言逐位一致的三条硬规则、以及一份可一键复现的校验脚本。遇到「书里的数字对不上」时先看这一页。
卷一的复现手册:两个 python3(python3 3.14.6 与系统 3.9.6)的区别与陷阱、Node 26 原生跑 TypeScript 的 strip-only 约束、Playwright 复用写法(NODE_PATH 对 ESM import 无效)、pebble 目录结构与全部实跑命令,以及一份可一键运行的环境自检脚本。数字对不上时先看这一页。
这一页讲清楚三件事:三卷各自负责什么、贯穿项目《合成小岛》与工具链 pebble(config / sim / core / web)长什么样、以及代码块头部的层级注释和 verify 命令该怎么读。读完你能在本机把书里任意一段代码跑起来,并知道一个数字是从哪一层出来的。
识别出事、归类出事之后,最后一节回答出事那一刻该做什么。先把处置拆成发现、止血、定位、修复、补偿、复盘六步,再把最难的决策——回滚——切成三条边界:哪些能回滚、哪些只能补偿、哪些只能接受。配一段可跑的仿真,把「发多了资源」的一次事故在三种处置下算成货币通胀与玩家损失,并给出等权代价最小的推荐。
把素材账分成两条腿:外包的计现金、内制的计人天,用一份素材成本表按「数量 × 单价」汇总出《合成小岛》的现金成本与内制工时,全程整数、金额用分记账,产 CSV 与 SVG 条形图,并讲清为什么「看外包成本不能只看现金」,以及外包单价、授权边界与交付验收三条纪律。
把一款小游戏的人拆成人天:用一份角色配置表,把每个角色的投入人天乘上日单价,汇总出总工时、折合人月、并行工期与人力成本结构,全程整数、金额用分记账,产 CSV 与 SVG 条形图,并讲清「排期」和「估算」这两个词为什么不能混着用,以及为什么并行工期只是个下界。
《小游戏开发实战》卷一《市场、品类与产品设计》全 50 篇。第一部分(第 1–5 章)讲小游戏定义与平台生态、市场规模、榜单与竞品拆解、品类图谱与加权评分选型、包体与首包约束、用户画像与生命周期;第二部分(第 6–11 章)讲核心循环、关卡与难度曲线、成长与放置收益、社交裂变、变现设计前置、立项文档与止损线;第三部分(第 12–15 章)讲原型验证、收入拆解与情景分析、资源计划、评审与设计案交付。每一节都配可跑的 Python 仿真、TypeScript 内核或单文件 HTML 原型,围绕虚构小游戏《合成小岛》与贯穿工具链 pebble 展开。
《SLG 游戏产品设计》卷一《产品架构与经济系统》全 50 篇。第一部分(第 1–8 章)讲产品定位与品类、玩家分层与动机、核心循环与节奏、系统地图与依赖、功能架构与模块边界、交互与信息架构、版本规划与内容节奏、指标体系与埋点框架;第二部分(第 9–15 章)讲资源与货币体系、产出端、消耗端、产出回收闭环、通胀与通缩治理、交易与市场、经济风控与事故复盘。每一节都配可跑的 Python 仿真或 TypeScript 原型,围绕虚构 SLG《王朝纪元》与贯穿工具链 bastion 展开。
把页面栈、共享状态、缓存数据层与离线写队列串成一条可运行的端到端基线:用注入适配器在进程内复现冷启动、缓存命中、弱网兜底与进程重启后的队列续传,给出 TypeScript 实现、五个测试的真实输出,并说明 L2 基线能证明与不能证明的边界。
卷一术语表:按领域建模、架构风格、数据一致性、接口通信、运行可用性、组织治理六组收录常用词,给出英文、本书用法和常见混淆;单列十组最容易混用的概念、五个容易过时的定义、常见缩写与章节对照,并在写作 ADR、接口文档和评审记录时提供统一口径,方便阅读时快速定位。
把卷一的基线、未知项和未决问题整理成可交接清单:八条基线中五项没有生产数据,六个问题全部带 owner、截止日期和对应卷二主题;Go 就绪门禁检查 measured 是否可复核、unknown 是否有计划、阻塞问题是否有截止日期,并明确“可以开始卷二”不等于“可以宣称性能指标”。
评审一个与 2.3 不同的候选方案:把订单与库存合并为 order-core 单服务。先固定六条证据、四条反对意见和三个重审条件,再用 Go 评分器把证据缺口、未关闭的阻断意见与决策一致性折算成分数;演练明确基于 arch-lab,不是真实公司会议。
把卷一散落在各章的决策收敛成一条可检查的链:需求与约束先变成驱动因素,七条 ADR 再按依赖关系排序;给出带 drivers、depends_on、备选与否决理由、正负后果的 Go 索引结构,并用校验器捕获孤立 ADR、缺失备选、无后果、非法日期与依赖环。
《MMO 服务器开发》卷四《工程化与运营》全 30 篇,是整套书的收官卷:把前三卷造出来的 aegis 交付出去并长期运营好。十个部分覆盖压测口径与机器人压测平台、承载评估与容量规划、帧预算与性能剖析、Go GC 与 JVM GC 双栈实测对照、热区隔离与背压、日志与指标与链路追踪、容器化编排与蓝绿灰度滚动发布、优雅停服与有状态服务发布、配置版本化与差量分发、热重载边界与线上回滚、指标口径与埋点管道、留存付费与漏斗分析、GM 权限审计与命令补偿、客服数据修复流程、备份恢复与多活切换、演练与事故复盘,最后把《晨曦大陆》装配成可交付形态并给出跨栈对照矩阵与全书收官。
埋点质量决定端上观测的上限。本节把事件命名、必填字段、类型校验、时间戳与 session 规则写成可运行的注册表与校验器,解释如何用发送数与接收数检测丢失,并用 schema 对比管理口径变更,避免一次字段改动静默破坏历史数据与下游报表口径。
崩溃与卡顿的难点不是采集,而是把海量原始样本收敛成可行动的少数分组。本节给出崩溃消息归一化与签名聚合、卡顿阈值与样本字段设计、归因顺序(布局抖动、主线程阻塞、长任务),以及上报事件应携带的最小证据字段,并用可运行的 TypeScript 与真实测试输出验证每一步判断与取舍。