一句话总结:技术文的配图只有两种算合格:能核对的数据图,和说清结构的流程图。其余都是装饰。这篇讲前者怎么写——一张表、一段脚本、一行数据来源,让读者能顺着图注点回原始出处。
站上这半个月发的十几篇,配图全是脚本画的。有读者问为什么不直接用截图或者生成图。 答案很功利:数据图能被复核,截图和生成图不能。一张画着「四档显存」的图,读者扫一眼就知道你在说什么;一张精美的插画,读者看完什么也没记住。
这篇把做法写下来,代码可以直接用。
先定图的类型,别先想好不好看
我把技术文的图分成四类,按使用频率排:对照表、横向柱、前后对比、结构流程。 对照表用得最多。四档显存、六个环节、三条路径,这类「把并列项摆开」的内容,表比任何图形都清楚。
横向柱适合比大小,尤其是类别名较长的时候。比如「21 个工具按组分布」,竖着写字会挤,横着排刚好。 前后对比适合展示改动收益。改前改后两组数并排,读者一眼看出倍率。 结构流程适合讲顺序,比如「一次会话的三步」。这类图不要画成装饰性的圆圈箭头,画成表格反而更省事。

图 1:用得最多的是对照表,最容易画错的是流程
一段能直接用的脚本
我用的是 matplotlib,不需要额外依赖。核心就三件事:读数据、画、在左下角写一行来源。
import matplotlib
matplotlib.use("Agg")
import matplotlib.pyplot as plt
plt.rcParams["font.sans-serif"] = ["Noto Sans CJK SC"]
plt.rcParams["axes.unicode_minus"] = False
labels = ["7B", "14B", "32B", "70B"]
values = [5.5, 9.3, 19.0, 38.5]
fig, ax = plt.subplots(figsize=(7.5, 3.4), dpi=150)
bars = ax.bar(labels, values, color="#2f6fd0", width=0.6)
for b, v in zip(bars, values):
ax.text(b.get_x() + b.get_width()/2, v + 0.6, f"{v} GB",
ha="center", fontsize=9)
ax.set_title("Q4 量化 + 8K 上下文下的显存需求", fontsize=12)
ax.set_ylabel("GB")
ax.spines[["top", "right"]].set_visible(False)
fig.text(0.01, 0.01, "数据来源:按三笔账估算,非实测", fontsize=7.5, color="#666")
fig.tight_layout(rect=[0, 0.04, 1, 1])
fig.savefig("vram.png", facecolor="white")
几个细节值得说。字号要给到 9 以上,手机上看不清的图等于没画。上下左右多余的边框关掉,视觉噪音少一半。左下角那行来源字号 7.5 就够,它的作用是留痕,不是给人细读。
中文字体必须显式指定,否则中文会变成方块。这类问题第一次遇到会以为是编码错误,其实是字体没配。
图注为什么比图本身更重要?
我的规矩是:每张图下面必须有一句话,说清「这张图在回答什么」,再加上数据来源。 反例是只写「图 1」。这种图注等于没有,读者得自己猜你想表达什么。
好图注有两个特征:一是它能让读者不看正文也懂图,二是它承认口径。比如「每一档都按同一条线算,条件变一个结论就要重算」,这句话把假设摆在了明面上。
图注写得好不好,可以对照发布助手那篇里的做法:每张图下面一段说明加一行口径,读者一看就知道这条结论能信几分。
数据来源那一行也一样。写「按 README 整理」和写「我估的」,可信度完全不是一档。前者读者能点回去核,后者至少诚实。
4 个我踩过的坑
第一个是千分位逗号。表格里写「1,037 tok/s」,脚本按逗号分列,列数对不上直接报错。要么去掉逗号,要么改用不会冲突的分隔符。
第二个是参数名。同一个脚本里,柱状图用 --label 和 --value,传成复数形式会被拒。这类错误不报歧义,只报「不认识这个参数」,第一次遇到容易怀疑脚本本身有问题。
第三个是用折线图画离散状态。我试过用折线表达「四步里哪步有回包」,结果画出一条 1、0、1、1 的抖动曲线,看着像趋势,实际是布尔值。离散量用表格,别用折线。
第四个是图片体积。同一张图,dpi 从 150 提到 300,体积翻四倍,阅读增益几乎为零。150 够用,除非图里有小字。
配图要和正文的论点对齐
图不是正文的复读,也不是装饰。它应该承担一句话说不清的那部分。 判断方法:如果删掉这张图,正文信息量没有损失,那这张图就该删。
反过来,如果正文里有一段「四项对比」写得读者要反复回看,那就是该配图的地方。
我在质检复盘那篇里写过一条:扣分项是提示,不是方案。配图也类似,形式合规不等于有用,最终还是要看它替读者省了多少脑子。
什么时候干脆不要图?
只有一个数字的时候,不要图。写进句子里就行。 纯流程不超过三步的时候,不要图。三句话说清,比画三个框更省读者的时间。
数据本身不可靠的时候,更不要图。图会给数字镀一层权威感,这个效果很危险,尤其是你自己都没把握的数。 这三条我都在同一周里犯过。删掉后的文章反而更紧。 如果你刚开始给技术文配图,我的建议是先只做对照表这一类。同一套版式做十篇,你会发现哪一类内容天然适合表格,剩下的再考虑柱状和流程。
FAQ
Q:必须用 Python 吗?
不必。关键是「脚本生成」这个形式,它保证图和数据一致,换工具也一样。
Q:中文字体怎么装?
装一个开源中文字体,在脚本开头指定字体名即可。名字写错不会报错,只会显示方块。
Q:图要压多大?
宽度 1200 像素上下,150 dpi 就够。再大只是浪费带宽。
参考资料
- Matplotlib 官方示例库(柱状、表格与标注的写法)
- Matplotlib · rcParams(字体与负号的全局配置)
口径与核验:脚本骨架来自本站配图用的实际代码,去掉业务参数后可直接跑;四个坑(千分位逗号、参数名、折线表达布尔、dpi 体积)都是实际操作时撞出来的。文中没有测过不同博客主题下的最佳尺寸,1200 像素是本站采用的值,不构成通用建议。
- FAQ
- 参考资料
发表评论
◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。