用 graphviz 画关系图:四个例子
背景
graphviz 的网站上对它的介绍大意是:一套用来描述"结构"的工具,布局交给程序算。我们只需要写清楚"谁连着谁、这条线代表什么",方块摆在哪里、线怎么绕,都由它决定 ⬇️
What is Graphviz?
Graphviz is open source graph visualization software. Graph visualization is a way of representing structural information as diagrams of abstract graphs and networks. It has important applications in networking, bioinformatics, software engineering, database and web design, machine learning, and in visual interfaces for other technical domains.
所以它适合画的不是清单,而是关系。
一条信息如果只是"A 和 B 有关系",用列表写就够了:
text
岳不群 - 岳灵珊
宁中则 - 岳灵珊
画成两个方块加一根线,读者不会多得到什么。我觉得值得画成图的关系,至少要满足下面三条中的一条:
- 边的种类不止一种------既有父子,也有夫妻;既有熔化,也有凝固
- 结构上有层次、有分叉、有双向------这些东西用文字描述费劲,用图一眼就能看出来
- 读者需要对照着看------两个家族怎么被一桩婚姻串起来、南北朝的演化过程中有哪些具体的朝代
后面四个例子分别来自人物、物理、历史三个领域,用的是同一套 DOT 语法,各自展示一种不同的结构:边的语义、角色层级、方向与成对关系、并行与收束。
准备环境
先让图渲染出来
安装方式以官网下载页为准,各平台都有说明;macOS 一行 brew install graphviz 就够了。装完 dot -V 能打印出版本即可,下文所有命令都基于 dot。
图里有中文的话,给 graph、node、edge 三处都设上 fontname(本文用 macOS 自带的 Heiti SC)------不设的话,部分系统会把中文渲染成方块。
更省事的办法是 Sketchviz:把 DOT 代码粘进浏览器就能实时出图,不用装任何东西,DOT 语法和本地 dot 完全一致------想先看效果,从这里开始就行。它还支持手绘风格的输出,适合截图发文章。
正文
例一:人物关系
《笑傲江湖》里岳不群一家和林平之一家的关系足够复杂:华山派掌门收福威镖局的少爷为徒,女儿又嫁给了他。整理成 6 个节点,每条边标注关系类型:
dot
digraph xiaoao {
rankdir=TB;
graph [fontname="Heiti SC", nodesep=0.5, ranksep=0.5];
node [shape=box, style="rounded,filled", fillcolor=white, fontname="Heiti SC", fontsize=12];
edge [fontname="Heiti SC", fontsize=10];
subgraph cluster_yue {
label="华山派 · 岳家"; labelloc=b; style=dashed; color=gray;
yuebuqun [label="岳不群"];
ningzhongze [label="宁中则"];
yuelingshan [label="岳灵珊"];
}
subgraph cluster_lin {
label="福威镖局 · 林家"; labelloc=b; style=dashed; color=gray;
linzhennan [label="林震南"];
linfuren [label="林夫人"];
linpingzhi [label="林平之"];
}
yuebuqun -> yuelingshan [label="父女", color="#1565C0"];
ningzhongze -> yuelingshan [label="母女", color="#C62828"];
yuebuqun -> ningzhongze [label="夫妻", dir=both, style=dashed, color="#6A1B9A", constraint=false];
linzhennan -> linpingzhi [label="父子", color="#1565C0"];
linfuren -> linpingzhi [label="母子", color="#C62828"];
linzhennan -> linfuren [label="夫妻", dir=both, style=dashed, color="#6A1B9A", constraint=false];
yuebuqun -> linpingzhi [label="收徒", color="#2E7D32"];
yuelingshan -> linpingzhi [label="夫妻", dir=both, style=dashed, color="#6A1B9A"];
}
(下图是在 Sketchviz 用以上代码生成的)

节点不多,但比列表多出三个维度:
label给边定了类型:父子、母女、师徒、夫妻,读者不用猜color是第二套编码:蓝父系、红母系、绿师徒、紫虚线夫妻,正文里交代清楚subgraph cluster_*圈出两家,"收徒""嫁娶"于是成了跨框的边
三个坑:
- 簇标题默认占顶部 ,会和"夫妻"虚线挤在一起,用
labelloc=b挪到底部 - 节点要先声明 ,否则图上印的是
linfuren这样的英文 id - 同层的夫妻边要加
constraint=false,否则它参与分层,会把宁中则挤到另一列
例二:权力结构
《动物庄园》的角色天然分几层:人类在农场外面,猪在内部掌权,干活的马和驴在最底下。dot 只保证"有边相连的,上层的在上、下层的在下",同一层的节点会被上下游的边拉得参差不齐,看不出层次。
解决办法是把每一层显式钉在同一条线上:
dot
digraph animalfarm {
rankdir=TB;
graph [newrank=true, fontname="Heiti SC", nodesep=0.35, ranksep=0.6];
node [shape=box, style="rounded,filled", fillcolor=white, fontname="Heiti SC", fontsize=12];
edge [fontname="Heiti SC", fontsize=10];
subgraph cluster_human {
label="人类"; labelloc=b; style=dashed; color=gray;
jones [label="琼斯先生\n(原农场主)"];
frederick [label="弗雷德里克\n(平奇菲尔德)"];
pilkington [label="皮尔金顿\n(福克斯伍德)"];
whymper [label="温普尔\n(律师)"];
}
subgraph cluster_farm {
label="庄园"; labelloc=b; style=dashed; color=gray;
oldmajor [label="老少校"];
napoleon [label="拿破仑", fillcolor="#FFF3E0"];
snowball [label="雪球"];
squealer [label="吱嘎"];
boxer [label="拳师"];
clover [label="苜蓿"];
benjamin [label="本杰明"];
}
{ rank=same; jones; frederick; pilkington; whymper; }
{ rank=same; snowball; napoleon; squealer; }
{ rank=same; boxer; clover; benjamin; }
jones -> oldmajor [style=invis];
jones -> napoleon [label="被推翻", style=dashed, color="#455A64"];
oldmajor -> napoleon [label="思想遗产", color="#6A1B9A"];
oldmajor -> snowball [color="#6A1B9A"];
napoleon -> snowball [label="驱逐", style=dashed, color="#C62828"];
squealer -> napoleon [label="效忠", color="#6A1B9A"];
napoleon -> boxer [label="压榨", color="#1565C0"];
napoleon -> clover [label="统治", color="#1565C0"];
napoleon -> benjamin [label="统治", color="#1565C0"];
frederick -> napoleon [label="入侵", color="#E65100"];
pilkington -> napoleon [label="晚宴和解", color="#E65100"];
whymper -> napoleon [label="代办贸易", color="#455A64"];
}

三个要点:
{ rank=same; ... }管同层对齐。每条边只保证上下,同一层不钉住就会排成参差的斜坡- 跨簇必须加
newrank=true,否则rank=same会把节点从簇里挪出去,布局跟着乱 style=invis只排座次、不画线 :jones -> oldmajor用来把老少校压到人类下面一层,读者看不到这条边
省略也要说明:莫丽、绵羊群、九条狗和摩西都没画。猪之间的同层关系也只留了"驱逐"和"效忠"两条------同层平边最占地方,多了标签就互相压字。
例三:物态变化
前两个例子是"同一类关系、不同的人";这张图反过来:只有三个节点,却有六条边------每两个状态之间,两个方向各有一个名字。
dot
digraph phase {
rankdir=LR;
graph [fontname="Heiti SC", nodesep=0.5, ranksep=1.6, pad="0.2"];
node [shape=box, style="rounded,filled", fillcolor=white, fontname="Heiti SC", fontsize=13, penwidth=1.2];
edge [fontname="Heiti SC", fontsize=11];
solid [label="固态"];
liquid [label="液态"];
gas [label="气态"];
solid -> liquid [label="熔化", color="#C62828"];
liquid -> solid [label="凝固", color="#1565C0"];
liquid -> gas [label="汽化", color="#C62828"];
gas -> liquid [label="液化", color="#1565C0"];
solid -> gas [label="升华", color="#C62828"];
gas -> solid [label="凝华", color="#1565C0"];
}
(下图是在 Sketchviz 用以上代码生成的)

六个过程与它们的英文、吸放热对照如下 ⬇️
| 过程 | 方向 | 英文 | 吸/放热 |
|---|---|---|---|
| 熔化 | 固态 → 液态 | melt | 吸热 |
| 凝固 | 液态 → 固态 | freeze | 放热 |
| 汽化 | 液态 → 气态 | boil | 吸热 |
| 液化 | 气态 → 液态 | condense | 放热 |
| 升华 | 固态 → 气态 | sublime | 吸热 |
| 凝华 | 气态 → 固态 | deposit | 放热 |
读图时注意三点:
- 方向就是语义。熔化和凝固在同一对状态之间,但一吸热一放热,合成无向边就分不清了
- 颜色是第二套编码,但这张图里红蓝的含义和例一不同(例一是父系/母系,这里是吸热/放热)------每张图的图例都要单独交代
- 跨过液态的弧线表示"不经过中间状态"。升华、凝华是固态直接到气态
也可以把一对反向过程压成一条 dir=both 的边,图更紧凑;但一条边只能有一种颜色,标不出两边不同的吸放热,所以这里拆成了六条。
图里只画了最常见的三态,等离子体、超临界流体没有画。
例四:南北朝
最后一个例子换到历史:两条并行的王朝更替链,最后收束到同一个节点。
南北朝是分裂期,南北各自改朝换代;最后隋取代北周,又南下灭陈,把两条线合成一条。
dot
digraph dynasties {
rankdir=LR;
graph [fontname="Heiti SC", nodesep=0.3, ranksep=0.45];
node [shape=box, style="rounded,filled", fillcolor=white, fontname="Heiti SC", fontsize=11];
edge [fontname="Heiti SC", fontsize=9, color="#455A64"];
subgraph cluster_north {
label="北朝"; style=dashed; color="#1565C0"; fontcolor="#1565C0";
wei [label="北魏"];
dongwei [label="东魏"];
xiwei [label="西魏"];
beiqi [label="北齐"];
beizhou [label="北周"];
}
subgraph cluster_south {
label="南朝"; style=dashed; color="#C62828"; fontcolor="#C62828";
song [label="宋"];
qi [label="齐"];
liang [label="梁"];
chen [label="陈"];
}
sui [label="隋", shape=ellipse, fillcolor="#FFF3E0"];
wei -> dongwei;
wei -> xiwei;
dongwei -> beiqi;
xiwei -> beizhou;
beizhou -> sui;
song -> qi;
qi -> liang;
liang -> chen;
sui -> chen [label="589 年灭陈", style=dashed, color="#E65100"];
}
(下图是在 Sketchviz 用以上代码生成的)

三个要点:
- 两个簇是两个并行世界。框在这里是政治边界,不是分类标签;隋在框外,是两条线的收束点
- 年份没标在图上,先后顺序就是箭头的方向,具体区间按名字查资料即可
- 虚线表示"灭"而非"继承"。隋→陈 是灭国,橙色虚线把它和其余"取代"边区分开
容易看错的是北魏:534、535 年分裂成东魏和西魏,图上是两条从北魏出发的边,不是一条链上的两段。十六国、柔然、突厥这些周边势力没有画,这张图只回答南北两朝怎么更替、怎么收束。
语法速查
表里的写法都在前面的例子里跑通过,但语法细节、可选值和版本差异,还是要以官网为准:属性列表、节点形状、DOT 语言。
| 想表达什么 | 写法 |
|---|---|
| 布局方向 | rankdir=LR(左到右)、TB(默认,上到下) |
| 同一层对齐(层级、同辈) | { rank=same; a; b; c; },跨簇时需 newrank=true |
| 一对状态之间的正反过程 | 拆成两条边各配一色;或用一条边加 dir=both |
| 节点形状 | shape=box / ellipse / note / record |
| 圆角 + 填充色 | style="rounded,filled",fillcolor="#E3F2FD" |
| 边上的关系文字 | a -> b [label="父子"] |
| 固定同层节点的上下顺序 | 父节点加 ordering=out,按声明顺序摆放 |
| 按类型配色 | color="#1565C0",penwidth=2 加粗 |
| 对称关系 | dir=both |
| 虚线(间接 / 次要关系) | style=dashed |
| 分组框 | subgraph cluster_xxx { label="岳家"; ... } |
| 簇标题位置 | labelloc=t(默认)/ b |
| 只影响排版、不画线 | style=invis |
| 中文 | graph / node / edge 三处都要设 fontname |
| 导出图片 | dot -Tpng、-Tsvg、-Tpdf |
| 输出更清晰 | dot -Gdpi=180 -Tpng |
| 换布局引擎 | -Kdot(默认)、-Kneato、-Kcirco、-Kfdp |
本地生成的命令很简单:
bash
dot -Gdpi=180 -Tpng 01-xiaoao.dot -o 01-xiaoao.png
dot -Tsvg 01-xiaoao.dot -o 01-xiaoao.svg # 网页里用 SVG,缩放不糊
-Gdpi=180 在写文章时挺实用:默认 96 dpi 的图在手机上放大后会发虚,输出时提高分辨率比事后拉伸好。
小结
四个例子,四种结构:
| 例子 | 结构 | 主要手法 |
|---|---|---|
| 笑傲江湖 | 两家人(跨框的师徒、婚姻) | label、color、cluster |
| 动物庄园 | 四层权力链(层次) | rank=same + newrank=true + style=invis |
| 物态变化 | 三态六过程(成对的反向边) | 方向即语义、颜色编码吸放热 |
| 南北朝 | 两条更替链(并行 + 收束) | 双簇并行、虚线区分"灭" |
回到开头的三条标准:
- 边的种类超过一种吗? 全是"父子"的话,列表就够了
- 结构有层次、分叉或双向吗? 有的话,文字描述会很啰嗦
- 读者需要对照吗? 需要的话,图扫一眼就完,文字不行
都不满足就用列表,满足任意一条就值得画。领域换来换去,DOT 的写法几乎不用改,变的只是标签。