一条可核对的技术书籍勘误应先写清书名、版次和章节，再描述最小输入、环境、预期或需要澄清的问题、实际结果与对照结果。显示异常、内容事实、译文歧义和代码输入契约需要不同证据。
一份好的反馈应该让维护者找到同一段内容，并按记录的步骤核对现象。普通读者从章节名、短引文和错误原文开始即可；文件 hash、精确运行时或 EPUB fragment 等技术字段只在确有需要时补充。
技术书籍勘误先分类，再决定证据
| 问题类型 | 先记录什么 | 避免直接断言 |
|---|---|---|
| 显示问题 | 设备、阅读器版本、主题、字号、章节与截图 | 内容本身一定错误 |
| 事实或代码 | 版次、位置、最小输入、环境、实际与对照结果 | 作者、译文或整本代码都有缺陷 |
| 译文或术语 | 短引文、上下文、术语前后用法与疑问 | 仅凭个人偏好判定错译 |
| 输入契约 | 支持范围是否写明、边界输入与不同顺序的结果 | 未声明的输入一定应被支持 |
如果问题只发生在目录、代码块、图表或公式显示，可先按技术EPUB阅读检查记录位置和阅读环境。代码折行、字体或主题问题则可参考EPUB代码高亮与排版检查，避免把视觉问题误报成源码变化。
电子书勘误定位：章节、短标识与版本要同时写
页码在可重排 EPUB 中可能随字号和阅读器改变，因此优先写：
- 完整书名、版次和可核的 ISBN；
- 章号、可见小节标题，以及靠近问题的函数名、图号或短引文；
- 文件或商品标识，但不附受保护下载 URL；
- 如阅读器能提供稳定位置标识，可作为补充，而不是所有读者的必填项。
“第二章某处有错”仍然太宽。“第二章 GCD 函数、test_gcd 与命令行片段，输入 0 42 时”就能把维护者带到具体上下文。短引文只保留定位所需范围，初次反馈提供定位所需的局部截图或短引文；如需完整文件，再按联系渠道的要求确认提供方式。
电子书错误反馈：用最小复现分开预期与实际
EPUBCheck 的 Filing an Issue 指南要求报告当前行为、预期行为和详细复现步骤。MDN 的浏览器问题报告指南还强调最小复现、版本，以及必要的截图或日志。这里借用的是信息结构，不表示图书问题应该提交到这些项目的 issue tracker。
- 删去无关步骤。保留触发现象所需的最小章节、输入或阅读器操作。
- 写清环境。阅读器问题记录 App、版本、设备、主题和字号；代码问题记录运行时、版本、操作系统及相关设置。
- 分开预期与实际。如果预期尚不确定，就明确写“请求澄清”，不要虚构唯一正确答案。
- 增加对照。用相近但未触发问题的输入，帮助判断是数据、顺序、环境还是整段逻辑。
译文问题复现要保留上下文，而不是只换一个词
报告译文疑问时，记录章节、可见句或术语，以及它与相邻段落、代码、图表或同书其他用法的冲突。可以写“这里的术语是否应与第 X 节保持一致”，但没有核对原文和上下文时，不应直接指控译者或作者。涉及换行或字符显示时，另外记录字号、主题与阅读器；原文字词或标点影响含义时，保留相邻上下文，等待核对。
真实边界复现：零值顺序不同，应先请求澄清输入契约
本站从所提供的中文授权 EPUB 中选取《Rust 编程：快速、安全的系统开发（第三版）》第二章的 gcd、test_gcd 和标准库命令行三个代码块，在不修改 GCD 与 CLI 逻辑的情况下组合复现。该书署名 Jim Blandy、Jason Orendorff、Leonora F. S. Tindall；这里的书目链接只用于确认本次副本身份与章节背景：《Rust 编程（第三版）》商品资料。
记录环境为编译器 rustc 1.99.1、macOS 27.0.1 arm64；使用 edition 2024 编译设置，它不是图书版次。一个书内单元测试函数中的 3 条断言通过；这只说明选定断言在该环境中通过。
| 输入 | 实际观察 | 在反馈中的作用 |
|---|---|---|
42 56 |
退出 0，结果 14 | 正例对照，说明基本路径可复现 |
0 42 |
退出 101，求余除零 panic | 最小边界现象与错误摘要 |
42 0 |
退出 0，结果 42 | 说明零值所在位置影响行为 |
0 0 |
退出 0，结果 0 | 书内测试覆盖的零值对照 |
已读片段没有完整声明命令行两参数的全部输入域。因此合适的预期是：“请澄清哪些包含零的输入属于示例支持范围，以及是否应在命令行输入处校验或在章节中说明限制。”这份记录保留为输入契约的澄清请求，尚未确认原因属于作者、译文、编译器或书籍内容。所选三个块来自这份中文副本，不能代表英文原版、其他版次或全书代码。
书籍错误反馈模板：复制后删去不适用字段
状态：未发送
书名 / 版次 / ISBN：
章节 / 小节 / 短定位标识：
问题分类：显示 / 内容 / 译文 / 输入契约待澄清
环境：阅读器或运行时、版本、系统、相关设置
最小步骤或输入：
预期行为，或希望澄清的问题：
实际行为与错误摘要：
对照输入及结果：
证据：脱敏截图、短日志或文件 hash（按需）
隐私检查：不含密码、验证码、支付信息或完整下载链接模板中的“预期”可以是一个问题，而不必先提供修复方案。读者可以补充问题对阅读或学习任务的实际影响；收到回复或确认修订后，再记录真实的处理结果。本站为上述 GCD 例子准备的匿名化记录仍是 not_sent，没有提交、回执、修复或处理时限。
联系前先脱敏，再选择公开通道
本站联系与阅读帮助页面提供公开邮件入口，并建议说明书名、问题位置、发生时间、已尝试操作和必要截图。下载问题可在确有需要时提供订单号，但不要发送账户或支付密码、验证码、完整支付卡信息或完整下载链接。
该页面只证明联系入口存在，不代表出版社勘误通道、处理 SLA、退款结果或作者修订承诺。发送前再检查一次：是否能定位、能否最小复现、是否分清观察结果与待确认判断、日志是否脱敏，以及是否把显示问题与内容问题分开。
本文只复核选定授权片段、运行记录和匿名化未发送模板，没有提交任何邮件或投诉，也没有确认书籍错误或修订版本。
