图目录

图目录:从图形出现即完成推进到图号、视觉主张、图例口径与复核证据相互对应。

学习目标

  • 能通过图号定位正文上下文、图例、变量定义和来源。
  • 能区分图形呈现的视觉关系与必须由文字说明的条件、边界和结论。
  • 能让第二位读者用同一输入重建图中的主张,并诊断图例缺失或引用错位。

为什么需要这一机制

图目录不是插图数量的清单,而是视觉证据的入口。一个图号只有在正文主张、图例口径、读者任务和复核步骤都能对应时才有用;漂亮的形状不能替代单位、变量和适用范围。

先避开三个视觉误区

核心合同与操作术语

是入口;决定“这张图在说明什么”。让读者知道如何读图。

把视觉信息接到行动;防止视觉印象独立漂浮。

目录节点逐项深读

图目录

图目录的工程任务是把每个图号接到可复查上下文。引用一张图时,应同时保存正文主张、图例、数据口径、版本和读者要回答的问题;若图形只能提供方向,文字必须补充条件和失效边界。

最小可重放实现

figure = locate(figureNumber, surroundingText)
claim = state_visual_claim(figure, legend, units)
prediction = write_expected_reading(claim)
replay = independent_reader(figure, same_input)
record(prediction, replay, boundary)

正常轨迹验证主张与图例一致;边界轨迹改变单位或观察窗口;故障轨迹删除图例或错引图号;复位轨迹从同一正文上下文重建阅读。通过标准是第二位读者能指出首个偏离,而不是“看起来合理”。

先预测,再操作证据实验

先预测改变图号、图例或读者任务后哪个节点会变化,再只切换一个场景。专属面板是教学模型,不复现任何原书插图。

图目录 · 证据实验

图号 → 视觉主张 → 图例口径 → 读者任务 → 复核证据

固定版本、输入和观察窗口,只改变一个条件;先预测首个偏离,再用同一基线复位。

结构条目也必须连接到可复查证据标题负责定位,合同、输入、结果和复位负责裁决1图号定位上下文当前节点2视觉主张图在说明什么可复核3图例口径变量与单位可复核4读者任务如何阅读可复核5复核证据能否重放可复核基线:图号、图例、正文主张和读者任务彼此对应。证据合同:输入 · 预期 · 实际 · 首个偏离 · 复位结果当前场景:正常路径

练习与答案

练习

问题 1:补齐图引用。 同事只写“见图 2-4”,请列出至少四个必须补充的字段。

问题 2:诊断视觉误读。 一条曲线在右侧上升,为什么不能直接说“性能变好”?

问题 3:设计复核。 如何让另一位读者验证一个流程图的箭头?

术语表

名词解释

本章出现的专业名词,用大白话再讲一遍。

图号
定位插图、标题、正文引用和来源的编号。
视觉主张
图形要表达的关系、变化或决策。
图例口径
变量、单位、颜色、方向和观察窗口的定义。
读者任务
读者使用图形要完成的判断或操作。
复核证据
能在固定条件下由第二位读者重建的图形结论。

本页小结

图目录的完成标准不是图号齐全,而是图号、视觉主张、图例口径、读者任务和复核证据相互对应。图形压缩关系,合同和实验负责裁决边界。

资料与写作方式声明

本章以Steve McConnell, Code Complete, Second Edition权威目录界定学习范围,并结合正文列出的技术资料独立重写;不宣称复现原书正文,也不沿用原作表述。

原作版权归作者与出版社所有;本站原创教学结构与表述仅供学习交流。

讨论

评论区加载中…