1. 从diagram-design这个标题里能读出什么第一次看到diagram-design这个标题我脑子里蹦出来的第一个念头是这大概率不是一个单纯的画图工具项目而是一套关于图表设计的方法论或者设计系统。为什么这么说因为如果只是某个绘图库或者某个在线作图网站标题通常会带上具体的技术栈或者产品名比如xxx-drawxxx-chart之类。而diagram-design这种命名方式更像是把图表和设计两个词并列强调的是设计这件事本身而不是某个具体的实现。我在实际工作中接触过不少和图表打交道的场景技术方案里的架构图、产品文档里的流程图、汇报材料里的数据可视化、甚至给非技术同事解释一个复杂逻辑时随手画的示意图。这些场景有一个共同点——图不是画给自己看的是画给别人看的。这就引出了diagram-design这个标题背后最核心的价值如何让一张图在没有人讲解的情况下自己把话说清楚。这个内容适合谁看我梳理了一下大概有三类人。第一类是技术从业者平时要写设计文档、画架构图、做技术分享图的质量直接影响沟通效率第二类是产品、运营、设计岗位的从业者需要频繁用图表表达流程、结构和关系第三类是任何需要用图说话的人包括学生做汇报、职场人写方案。不管你是哪一类只要你有过图画完了但别人看不懂的经历这篇内容就值得往下看。需要提前说明的是由于原始输入里项目正文、关键词、摘要描述都是空的我无法得知这个项目具体是某个开源库、某个设计规范、还是某个内部工具。所以接下来的内容我会基于diagram-design这个标题本身结合我在图表设计领域的实际经验从设计原则、工具选型、实操步骤、常见坑点这几个维度展开。所有涉及具体工具和参数的部分都是基于行业常见实践的合理补充你可以根据自己的实际情况调整。2. 图表设计到底在解决什么问题2.1 图表的本质是降低理解成本很多人对图表设计有一个误解觉得图好看就行。我刚开始做技术方案的时候也这么想花大量时间调颜色、调字体、调对齐结果图确实挺漂亮但同事看完还是问我这个箭头是什么意思这两个框为什么连在一起。后来我才明白图表的核心不是美观而是降低信息的理解成本。你可以做一个简单的对比。同样描述一个用户下单后系统如何处理的逻辑用文字写可能需要三百字读者要逐句理解、自己在脑子里构建流程而一张好的流程图读者三秒钟就能抓住主干。这中间的差距就是图表设计的价值。图表设计要做的是把读者需要在脑子里完成的推理工作提前到设计者画图的时候完成。这就意味着图表设计的第一原则不是我想怎么画而是读者会怎么读。人的阅读习惯是有规律的从左到右、从上到下、先看整体再看局部、先看突出的再看次要的。好的图表设计本质上是在顺应这些规律而不是对抗它们。2.2 三类最常见的图表及其设计侧重在实际工作中我遇到的图表大致可以分成三类每一类的设计侧重完全不同混为一谈是新手最容易犯的错。第一类是结构类图表比如系统架构图、组织架构图、模块依赖图。这类图的核心是关系读者关心的是谁和谁连在一起谁在谁上面谁依赖谁。设计这类图的时候层级关系必须清晰连线不能交叉太多同层级的元素要视觉上对齐。我见过太多架构图框画得挺大但连线像蜘蛛网一样缠在一起读者根本追不下去。第二类是流程类图表比如业务流程图、审批流、状态机。这类图的核心是顺序和分支读者关心的是先做什么后做什么什么情况下走哪条路。设计这类图的时候主干流程要放在最显眼的位置分支要明确标注条件回退和异常路径不能省略。很多人画流程图只画正常路径结果一到异常情况就抓瞎。第三类是数据类图表比如柱状图、折线图、饼图。这类图的核心是对比和趋势读者关心的是哪个多哪个少是在涨还是在跌。设计这类图的时候坐标轴要清晰数据标签要准确颜色不能滥用。我见过最离谱的一个饼图切了十二块每块颜色都不一样读者看完只记住了颜色很多完全没记住数据。下面这张表是我总结的三类图表的设计要点对比你可以对照自己的场景看看属于哪一类图表类型核心信息设计重点常见错误结构类元素间的关系层级清晰、连线简洁、对齐规整连线交叉、层级混乱、元素大小随意流程类步骤的顺序和分支主干突出、分支标注条件、异常路径完整只画正常路径、分支条件模糊、回退缺失数据类数值的对比和趋势坐标轴清晰、标签准确、颜色克制颜色过多、坐标轴截断、标签缺失2.3 为什么设计比工具更重要我经常被问到一个问题画图用什么工具好这个问题本身没有错但问这个问题的人往往把重点放错了地方。工具决定的是你能不能画出来而设计决定的是别人能不能看懂。我见过用最朴素的工具画出极其清晰的图也见过用最专业的工具画出让人抓狂的图。举个我自己的例子。早期我做技术分享用的是当时能找到的最专业的绘图工具功能确实强大各种特效、渐变、阴影都能加。结果我做出来的架构图每个框都有渐变和阴影看起来像立体的按钮读者第一眼被视觉效果吸引反而忽略了框里的文字和框之间的关系。后来我把所有特效去掉只保留最基础的矩形和线条图的清晰度反而大幅提升。这个经历让我明白一个道理图表设计中的减法比加法重要得多。每增加一个视觉元素都是在消耗读者的注意力。如果这个元素不承载信息那它就是噪音。所以我在设计图表的时候会反复问自己这个颜色有必要吗这个阴影有必要吗这个图标有必要吗如果去掉之后不影响理解那就去掉。3. 图表设计的四个核心原则3.1 原则一一个图只讲一件事这是我最想强调的一条原则也是最容易被违反的一条。很多人画图的时候恨不得把所有相关信息都塞进一张图里结果就是信息过载读者什么都记不住。我见过一张系统全景图里面包含了架构分层、数据流向、部署拓扑、监控点位、安全边界五套信息叠加在一起。画图的人觉得自己很厉害一张图讲清楚了所有事情但看图的同事私下跟我说他看了十分钟都没找到自己想看的那部分。这就是典型的什么都想说结果什么都没说清楚。正确的做法是一张图只回答一个问题。如果你想表达系统分几层那就画一张纯粹的分层图如果你想表达数据怎么流转那就画一张纯粹的数据流图。两张图分开画读者看第一张的时候建立整体认知看第二张的时候理解动态过程认知负担反而更小。当然实际工作中确实有必须在一张图里表达多个维度的场景比如给高层汇报的时候篇幅有限只能放一张图。这种情况下我的经验是用视觉分区来隔离不同的信息。比如把画布分成左右两块左边讲结构右边讲流程中间用一条明显的分隔线隔开。这样读者至少知道这块和那块是两回事不会混在一起理解。3.2 原则二视觉层级要匹配信息层级信息是有层级的有主干信息有次要信息有补充说明。图表设计要做的是让视觉上的突出程度和信息的重要程度匹配起来。重要的东西画得大、画得深、画得显眼次要的东西画得小、画得浅、画得低调。这个原则说起来简单做起来很容易翻车。我见过一个流程图主干流程和异常分支用的是同样大小的框、同样粗细的线、同样深浅的颜色读者根本分不清哪条是主路哪条是岔路。正确的做法应该是主干流程用粗线、深色、大框异常分支用细线、浅色、小框。这样读者一眼就能看出主路在这里岔路在旁边。具体到操作层面我通常用三个维度来建立视觉层级大小核心元素的尺寸是次要元素的1.5到2倍。不要小看这个比例人眼对大小的敏感度很高稍微大一点就能产生明显的层级感。颜色核心元素用高饱和度或深色次要元素用低饱和度或浅色。但要注意颜色数量控制在三到四种以内超过这个数量读者就记不住每种颜色代表什么了。位置核心元素放在画布的视觉中心或者阅读起点左上角次要元素放在边缘。人的视线会自然地被中心位置吸引这是可以利用的规律。3.3 原则三连线要能追得下去连线是图表设计里最容易被忽视、也最容易出问题的部分。很多人画图的时候框画得很认真连线随手一拉就完事结果就是读者追着线看追着追着就不知道追到哪里去了。连线出问题通常有三种情况。第一种是交叉太多两条线交叉还好五条线交叉在一起读者根本分不清哪条连哪条。第二种是没有方向箭头太小或者干脆没有箭头读者不知道信息是从A流向B还是从B流向A。第三种是绕路太远一条线从左边绕到右边再绕回来读者追到一半就放弃了。我的处理经验是这样的首先尽量减少交叉。如果两个元素之间必须连线但直接连会交叉那就调整元素的位置把有关系的元素放在相邻位置。其次箭头要明显。箭头的大小要和线的粗细匹配线粗箭头就大线细箭头就小但最小不能小于读者能一眼看清的程度。最后连线要短。如果一条线需要绕很远那说明元素布局有问题应该重新调整布局而不是硬连。还有一个细节连线的标签要放在线的旁边不要放在线的中间。放在中间会打断线的连续性读者追线的时候会被标签挡住。放在旁边读者既能看清线又能读到标签。3.4 原则四留白不是浪费空间新手画图有一个通病怕浪费空间恨不得把画布的每一个角落都填满。结果就是元素挤在一起读者看着累理解起来更累。留白的作用是给读者的眼睛休息的地方也是给不同信息块之间建立边界。你可以把留白理解成文章里的段落间距——没有段落间距的文章读起来会非常吃力有了段落间距读者才能自然地分段理解。我在实际操作中会保证元素之间的间距至少是元素本身尺寸的30%。比如一个框宽100像素那它和相邻框之间的间距至少要有30像素。如果是不同信息块之间间距要更大至少是元素尺寸的50%以上。这个比例不是绝对的但可以作为起步参考。另外画布的边缘也要留白。我见过很多图元素直接贴着画布边缘看起来非常局促。我的习惯是画布四周至少留出10%的空白让图有呼吸感。4. 从零开始设计一张图表的完整流程4.1 第一步先想清楚读者是谁、读者要什么这一步听起来很虚但实际上是整个流程里最重要的。我见过太多人一上来就打开工具开始画画到一半发现方向不对推倒重来浪费大量时间。我的做法是在动手之前先用文字回答三个问题这张图给谁看是给技术同事看还是给非技术背景的领导看是给熟悉业务的人看还是给完全不了解背景的人看读者的背景不同图的详细程度和表达方式完全不同。读者看完这张图需要知道什么是知道系统有几个模块还是知道数据怎么流转还是知道哪个环节是瓶颈目标越具体图的设计方向越清晰。读者会在什么场景下看这张图是在文档里自己看还是在你讲解的时候看是自己看那图要能独立表达是你讲解的时候看那图可以适当简化把细节留给你口头补充。这三个问题回答完你对这张图的定位就清楚了。接下来才是动手画。4.2 第二步用纸笔或白板先画草图这一步很多人会跳过直接上工具。但我的经验是草图阶段用纸笔或白板效率比直接用工具高得多。因为草图阶段的核心是想清楚结构而不是画得好看。用工具的时候你会不自觉地被对齐、颜色、字体这些细节分散注意力反而忽略了结构本身。草图阶段要确定的是有哪些元素、元素之间是什么关系、整体布局是横向还是纵向、主干和分支怎么安排。这些确定下来之后再用工具去实现就是纯粹的翻译工作效率会高很多。我在草图阶段通常会画两到三个版本对比哪个版本的结构更清晰。有时候第一个版本画完觉得还行但画第二个版本的时候会突然想到更好的布局方式。多画几个版本的成本很低但收益很高。4.3 第三步确定视觉规范再动手草图确定之后不要急着画第一个元素先把视觉规范定下来。视觉规范包括用几种颜色、每种颜色代表什么、字体用多大、框的圆角是多少、线条多粗、箭头什么样式。为什么要先定规范因为如果画到一半再改规范前面画好的元素都要跟着改非常浪费时间。而且先定规范能保证整张图的视觉一致性不会出现这个框是圆角那个框是直角这条线是蓝色那条线是绿色的混乱情况。我的视觉规范通常很简单主色一种辅助色一到两种中性色灰、白若干。字体只用一种通过字号大小来区分层级。框的样式只用一种要么全圆角要么全直角。线条只用两种粗细粗的表示主干细的表示次要。4.4 第四步先画主干再补细节动手画的时候顺序很重要。我的习惯是先画主干再补细节。先把最核心的元素和关系画出来确认整体结构没问题再往里面填充次要元素和说明文字。这样做的好处是如果中途发现结构有问题调整的成本很低。如果一上来就把所有细节都画上发现结构不对的时候改起来就非常痛苦。主干画完之后我会先自己看一遍问自己如果我只看到这些主干元素能不能理解这张图要表达的核心意思如果能说明主干是清晰的如果不能说明主干还需要调整。主干确认无误之后再补细节。4.5 第五步检查、检查、再检查图画完之后不要急着导出。我通常会做三轮检查第一轮检查信息准确性图里的文字有没有错别字数据对不对关系有没有画错这一步是底线信息错了图再好看也没用。第二轮检查视觉清晰度把图缩小到50%看一遍如果缩小之后还能看清主干结构说明视觉层级是清晰的如果缩小之后一片模糊说明元素太密或者层级不够分明。第三轮检查读者视角找一个不了解背景的同事让他看图然后问他你看完这张图觉得它在讲什么。如果他的回答和你的预期一致说明图是成功的如果他的回答偏离了说明图里还有歧义。5. 工具选型不同场景用什么画图5.1 工具选型的核心逻辑工具选型这件事我的观点是没有最好的工具只有最适合当前场景的工具。选工具的时候要考虑三个因素图的复杂度、协作需求、输出格式。图的复杂度决定了你需要多强的功能。如果只是画一个简单的三层架构图用任何工具都能搞定如果要画一个包含几十个节点、多层嵌套的复杂系统图就需要功能更强的工具。协作需求决定了你需要多好的共享能力。如果图只有你自己看本地工具就够了如果图需要团队一起编辑、一起评审就需要支持多人协作的工具。输出格式决定了你需要多灵活的导出能力。如果图要嵌入文档需要导出为图片如果图要放在网页上可能需要导出为矢量格式如果图要打印需要高分辨率导出。5.2 三类工具的适用场景对比我把常见的图表工具分成三类下面这张表对比了它们的适用场景工具类型代表特征适合场景不适合场景代码驱动型用文本描述图表自动生成图形需要版本控制、需要频繁修改、技术文档需要精细调整视觉效果、非技术人员使用拖拽操作型手动拖拽元素、手动连线快速出图、视觉效果要求高、一次性使用需要批量生成、需要版本控制专业设计型功能强大、学习曲线陡复杂图表、精细控制、专业出版快速出图、简单图表、新手使用代码驱动型的工具最大的优势是可版本控制。图是用代码描述的代码可以放在版本管理系统里每次修改都有记录多人协作也不会冲突。缺点是视觉效果调整起来比较麻烦而且需要学习特定的语法。拖拽操作型的工具最大的优势是上手快、视觉效果好。拖拖拽拽就能出图颜色、字体、样式都可以可视化调整。缺点是图多了之后管理起来麻烦而且很难做版本控制。专业设计型的工具功能最强大几乎可以实现任何视觉效果。但学习曲线也最陡而且对于简单的图表来说用这类工具是杀鸡用牛刀。5.3 我的实际选择经验在实际工作中我的选择策略是这样的如果是技术文档里的图表我优先用代码驱动型的工具。因为技术文档本身就在版本管理系统里图表用代码描述可以和文档一起管理修改起来也方便。而且技术文档里的图表通常不需要太复杂的视觉效果代码驱动型完全够用。如果是汇报材料里的图表我优先用拖拽操作型的工具。因为汇报材料对视觉效果要求高而且通常是一次性使用不需要版本控制。拖拽操作型工具能快速出图调整起来也直观。如果是需要精细控制的复杂图表比如要出版或者要打印的大图我会用专业设计型的工具。但这种场景不多大部分日常工作用前两类工具就能覆盖。还有一个经验不要频繁换工具。每个工具都有自己的操作逻辑和快捷键频繁换工具会导致你每个都不熟练。选定一个主力工具把它用透比什么工具都会一点但都不精要高效得多。6. 那些年我踩过的图表设计坑6.1 坑一颜色用太多读者记不住这是我早期最常犯的错误。觉得颜色多了好看一张图里用了七八种颜色每个模块一种。结果读者看完之后只记住了颜色很多完全没记住每种颜色代表什么。后来我给自己定了一个规矩一张图里的颜色不超过四种。一种主色用于核心元素一种辅助色用于次要元素一种强调色用于需要特别注意的元素再加上中性色灰、白、黑用于文字和背景。四种颜色足够表达大部分信息层级了。如果确实需要区分更多类别我会用同一种颜色的不同深浅来代替不同颜色。比如用深蓝、中蓝、浅蓝来区分三个层级读者能看出它们是一家人但又能区分出层级差异。这比用红、绿、蓝三种完全不同的颜色要好得多。6.2 坑二文字太多图变成了带框的文章我见过很多图每个框里塞了一大段文字读者要凑近了才能看清看完一个框就累了根本没精力看完整张图。图表和文章的分工是不同的文章负责详细阐述图表负责快速传达核心信息。如果图里的文字太多那图表就失去了快速传达的优势还不如直接写文章。我的处理方式是框里只放关键词详细说明放在图外的注释里。比如一个框里只写用户服务而不是写用户服务模块负责处理用户的注册、登录、信息修改等请求。如果读者需要了解详细内容可以在图下方加注释或者在图外的文档里展开。如果确实有些信息必须放在图里我会用分层展示的方式主框里放核心信息主框下方用一个小字号的副框放补充信息。这样读者先看到核心信息有兴趣再看补充信息不会一上来就被大量文字淹没。6.3 坑三对齐没做好图看起来歪歪扭扭对齐是图表设计里最基础、也最容易被忽视的细节。很多图单看每个元素都没问题但整体看起来就是不舒服原因往往是对齐没做好。对齐这件事我的经验是能用自动对齐就用自动对齐不要手动调。大部分工具都有对齐辅助线或者对齐功能画元素的时候让工具帮你对齐比手动拖拽精确得多。如果工具没有自动对齐功能那就用网格。在画布上铺一层网格所有元素都对齐到网格线上。网格的间距可以根据元素大小来定元素大网格就大元素小网格就小。还有一个细节文字的对齐也要统一。要么全部左对齐要么全部居中对齐不要这个框左对齐那个框居中。文字对齐不统一看起来会非常乱。6.4 坑四只顾着画忘了图是给人看的这个坑是最根本的也是前面所有坑的根源。很多人画图的时候脑子里想的是我要把我知道的都画出来而不是读者需要看到什么。我自己的转变发生在一次技术评审上。我花了两天画了一张自认为很完整的架构图结果评审的时候一位同事说你这张图信息很全但我看了五分钟还是不知道从哪里开始看。这句话点醒了我图的完整性不等于图的可用性。从那以后我画图的时候会刻意站在读者的角度想如果我是第一次看到这张图我的眼睛会先看哪里然后看哪里看完之后我能记住什么这个思考过程会倒逼我调整图的结构和视觉层级让读者的阅读路径更顺畅。7. 让图表自解释的几个进阶技巧7.1 用图例降低理解门槛图例是一个很小的元素但作用很大。如果图里用了不同的颜色、不同的线型、不同的形状来表示不同含义那就必须加图例。图例要放在显眼的位置通常是图的左上角或右上角不要放在角落里让人找不到。图例的内容要简洁一个色块配一个短词就够了不要写长句子。图例的样式要和图里的元素一致图里是圆角矩形图例里就用圆角矩形图里是虚线图例里就用虚线。7.2 用编号引导阅读顺序如果图里的元素有明确的阅读顺序比如流程图的步骤、架构图的层级可以用编号来引导。编号要放在元素的显眼位置通常是左上角或顶部居中。编号的字体要比元素内的文字大一号让读者一眼就能看到。编号的好处是读者可以按照编号顺序阅读不会漏掉步骤也不会跳着看导致理解断层。特别是对于步骤较多的流程图编号几乎是必需的。7.3 用注释补充关键信息图里放不下的信息可以用注释来补充。注释的位置要靠近相关的元素不要离得太远。注释的样式要和正文区分开通常用更小的字号、更浅的颜色。注释的内容要精炼只补充最关键的信息不要把图外的整段文档都搬进来。注释的作用是帮助理解图而不是替代图。7.4 用分组框划分信息区域如果图里的元素可以分成几个组用分组框把同组的元素框起来能帮助读者快速识别这几个是一伙的。分组框的样式要低调通常用浅色背景或者虚线边框不要用太重的颜色否则会喧宾夺主。分组框要有标签标签放在分组框的左上角或顶部居中说明这组元素是干什么的。标签的字体要比元素内的文字小一号但要比注释大一号形成清晰的层级。8. 关于图表设计我最后想分享的几点体会图表设计这件事说到底是一个翻译工作把脑子里的结构、流程、关系翻译成读者能看懂的视觉语言。翻译得好不好不取决于你用了多高级的工具而取决于你对读者怎么理解这件事的理解有多深。我做了这么多年图表最大的体会是好的图表是改出来的不是画出来的。第一版画完自己看一遍改找同事看一遍改放两天再看一遍再改。每改一次图都会更清晰一点。那些看起来一气呵成的好图背后都是反复打磨的结果。另一个体会是图表设计的能力是可以迁移的。你在画架构图时学到的分层级减噪音引导阅读这些原则在画流程图、数据图、甚至做PPT排版的时候都用得上。所以不要觉得我只需要画好这一种图把底层原则吃透什么图都能画好。最后一个建议多看好图多拆好图。看到一张让你觉得清晰的图不要只是感叹试着拆解它它用了几个颜色它的视觉层级是怎么建立的它的阅读路径是怎样的拆得多了你自己画图的时候这些规律就会自然地用出来。图表设计没有标准答案但有清晰和模糊之分。你的目标不是画出最漂亮的图而是画出最不容易被误解的图。当你画的图能让读者在没有人讲解的情况下自己看懂你就成功了。