★ FEATURED ARTICLE 1. 从diagram-design这个标题能读出什么第一次看到diagram-design这个标题我的直觉是这不是一个具体工具的名字而是一类工作的统称——围绕图这件事做设计。图可以是流程图、架构图、时序图、状态机图、思维导图、数据流图甚至是简单的方框加箭头。而design这个词落在后面说明重点不在画出来而在设计得对、设计得好。我做过不少和图表打交道的项目从给团队画系统架构图到给文档配流程图再到帮非技术同事把一堆口头描述整理成一张能看懂的示意图。踩过的坑非常多图太复杂没人看、符号用错引起误解、颜色乱用导致重点丢失、导出后模糊不清、改一版要重画半天。这些问题表面上是画图技巧问题根子上其实是设计思维问题。所以这篇内容我想聊的是当你拿到一个diagram-design的任务时应该怎么想、怎么选工具、怎么组织信息、怎么避免那些看起来不起眼但会让整张图报废的细节。适合谁看适合需要经常画图但没受过设计训练的技术人、产品人、文档写作者也适合想把自己画图流程规范化的团队。不需要你会用某个特定软件因为核心逻辑是通用的。我下面会从图到底为谁而画这个最容易被跳过的问题开始一路讲到工具选型、信息分层、视觉规范、协作维护最后分享几个我反复验证过的实操技巧。全程说人话给能直接抄的做法。2. 先搞清楚这张图是给谁看的再动手2.1 三种读者三种完全不同的画法很多人画图的第一步是打开工具这是错的。第一步应该是问这张图给谁看我把读者分成三类每一类对应的画法差异极大。第一类是自己看。这种图是思考草稿目的是帮自己理清逻辑。画法可以极其随意方框歪歪扭扭没关系颜色不用管甚至用纸笔更快。我经常在纸上画完再决定要不要电子化。这类图的价值在于画的过程画完可能就扔了。第二类是给同行看。比如给同组工程师画架构图。这类读者有专业背景能接受术语和缩写但对准确性要求极高。一个箭头方向画反、一个模块边界画错都会引起误解。这类图要精确、要标注清楚、要能经得起追问。第三类是给外行看。比如给管理层、给客户、给非技术同事。这类读者没有背景知识图必须自解释。术语要翻译成大白话抽象概念要用类比重点要极其突出细节要大胆砍掉。我见过最常见的错误就是拿给自己看的草稿直接给外行看结果对方一脸茫然或者拿给外行看的简化图去跟同行讨论技术细节结果被质疑不严谨。一张图不可能同时服务好三类人这是必须先做的取舍。2.2 先写一句话说明再画第一个方框我的习惯是动手画之前先用一句话写下这张图要说明什么。这句话必须包含主语、动作、结果。比如用户下单后系统如何一步步扣减库存并通知仓库。这句话写不出来说明你还没想清楚画出来的图一定是乱的。这句话写出来了它就成了整张图的锚——所有元素都要为这句话服务跟这句话无关的内容一律砍掉。这个习惯帮我省了大量返工时间。以前我经常画到一半发现这个模块好像也该放进去然后越加越多图越来越乱。有了这句话之后判断标准变得很简单这个元素对说明这句话有帮助吗没有就不画。2.3 图的复杂度上限七个元素原则心理学里有个被广泛引用的说法人一次能同时处理的信息块大约是五到七个。我把它当成画图的硬约束一张图里的核心元素尽量不超过七个。超过七个怎么办两个办法。一是分层主图只放最核心的七个细节用子图展开。二是拆图把一张大图拆成几张有逻辑关系的小图用编号或颜色关联。我做过一个系统架构图一开始把所有模块都塞进去二十多个方框密密麻麻。给同事看对方看了十秒就说太乱了不想看。后来我拆成三层第一层只画五个核心服务第二层展开每个服务的内部模块第三层画数据流向。同样的信息拆完之后理解成本下降了一大截。提示如果你发现一张图需要配一大段文字才能看懂那大概率是图本身没设计好而不是读者水平不够。3. 工具选型别被工具绑架先看图的类型3.1 按图的类型选工具而不是按习惯工具选型这件事我的核心观点是先确定图的类型再选工具。不同类型的图最优工具完全不同。图的类型推荐工具类型核心理由流程图/架构图声明式文本绘图工具版本可控、易修改、适合协作时序图/状态图支持UML语法的工具语义规范、自动布局思维导图专用导图工具层级展开方便、快速调整数据图表数据可视化库数据驱动、可复用手绘风格示意图手绘风格工具降低正式感、适合沟通高精度示意图矢量绘图工具像素级控制、导出质量高我特别想强调声明式文本绘图这一类。它的逻辑是你用文本描述图的结构工具自动排版。好处是修改极其方便——改一行文字图自动重排不用手动拖拽。对于需要频繁更新的技术图这类工具的效率是拖拽式工具的好几倍。3.2 拖拽式工具和文本式工具的真实取舍拖拽式工具就是那种用鼠标拖方框、拉箭头的上手快所见即所得适合一次性的、不需要频繁改的图。但它的致命问题是改起来痛苦。加一个元素可能要重新调整周围所有元素的位置换一个主题颜色全乱。文本式工具用代码或标记语言描述图上手有门槛要记语法但一旦上手修改成本极低。而且文本可以进版本控制谁改了什么一目了然这对团队协作是巨大优势。我的实际做法是探索阶段用拖拽式定稿阶段用文本式。先用拖拽工具快速试几种布局找到最清晰的方案再用文本工具把它固化下来。这样既有探索的灵活性又有维护的便利性。3.3 一个容易被忽略的选型维度导出与嵌入很多人选工具只看画起来顺不顺手忽略了导出和嵌入方不方便。这个维度在实际工作中极其重要。你需要考虑导出的格式是矢量还是位图矢量图放大不糊位图放大会糊。能不能导出透明背景能不能控制导出尺寸能不能直接嵌入到文档、网页、演示文稿里我踩过一个坑用某个工具画了张图导出PNG后发现文字模糊因为导出分辨率太低。重新导出高清版文件又太大嵌入文档后加载很慢。后来换成矢量导出问题才解决。所以选工具时一定先测试导出效果别等图画完了才发现导不出来。4. 信息分层让图自己会说话4.1 视觉层级的三要素大小、颜色、位置一张图能不能让人一眼看懂取决于视觉层级做得好不好。视觉层级就是什么最重要、什么次重要、什么可以忽略在视觉上的体现。三个最有效的工具是大小、颜色、位置。大小最直观。重要的元素画大一点次要的画小一点。但要注意大小差异要明显差一点点反而让人困惑——到底是重要还是不重要颜色最灵活。用颜色区分类别、标记重点、表示状态。但颜色不能滥用一张图的主色调最好控制在三种以内否则会显得杂乱。我常用的做法是主色一种强调色一种中性灰若干。位置最容易被忽略。人看图有固定的阅读习惯通常是从左上到右下。把最重要的元素放在视觉起点把结论性的元素放在视觉终点符合阅读习惯。另外中心位置天然比边缘位置更受关注。4.2 用分组代替连线减少视觉噪音新手画图喜欢用大量连线表达关系结果图变成一团乱麻。我的经验是能用分组表达的就不要用连线。比如三个模块都属于同一个子系统与其画三条线连到一个框不如把这三个模块放进一个带背景色的区域里。分组是隐性的关系表达比连线干净得多。连线只在表达流向依赖时序这类动态关系时才必要。而且连线要尽量走直线、少交叉。交叉线一多图就没法看了。如果实在避免不了交叉可以用跳线符号或者干脆重新布局。4.3 标注的艺术什么时候标、标什么、怎么标标注是图的注释系统用得好能大幅提升可读性用不好就是噪音。我的原则是只在读者会产生疑问的地方标注。比如一个缩写读者可能不认识标一下一个数字读者可能想知道单位标一下一个流程分支读者可能想知道触发条件标一下。标注的形式也有讲究。短标注直接写在元素旁边长标注用编号加图例。图例放在图的角落不要放在中间打断阅读。还有一个细节标注的文字要和图的整体风格一致。如果图是简洁风格标注也要简洁如果图是详细风格标注可以详细些。风格不统一会显得很业余。5. 视觉规范那些让图看起来专业的细节5.1 对齐和间距专业感的最大来源如果只能给一条让图变专业的建议我会说对齐。对齐是最容易被忽略、但效果最明显的细节。方框的左边缘对齐、上边缘对齐、中心对齐箭头端点对齐到方框边缘而不是悬空文字基线对齐……这些细节做好了图立刻显得规整。间距同样重要。元素之间的间距要均匀不能有的地方挤、有的地方空。我通常用网格思维想象图下面有一层看不见的网格所有元素都吸附在网格上。很多工具都有对齐辅助线和网格吸附功能一定要打开。5.2 字体和字号可读性优先字体选择的原则很简单可读性优先花哨靠后。正文用无衬线字体就是笔画粗细均匀、没有装饰角的那种标题可以稍粗代码或标识符用等宽字体。字号方面同一层级的元素字号要一致。标题比正文大正文比标注大。字号差异要明显不要用11号和12号这种几乎看不出区别的搭配。还有一个坑不同工具、不同系统的默认字体不一样导出后可能字体被替换导致排版错乱。所以要么用通用字体要么在导出时把字体嵌入或转成图形。5.3 颜色少即是多对比要够颜色用得好是加分项用不好是减分项。我的经验是颜色数量控制在三种以内对比度要足够。对比度不够是常见问题。浅灰背景配中灰文字看起来高级但实际很难读。特别是投影或打印时对比度不够的图基本报废。判断对比度够不够有个简单方法把图转成灰度如果还能分清层次说明对比度够。颜色还要考虑色盲用户。红绿搭配对红绿色盲不友好尽量用蓝橙、蓝黄这类对比。如果必须用红绿表示状态加上形状或文字辅助区分。5.4 一致性同一套图要像一家人如果你要画一组图比如一个项目的多张架构图一致性极其重要。同样的概念用同样的颜色、同样的形状、同样的位置习惯。这样读者看第二张图时不用重新学习图例。我维护过一套十几张的系统图一开始每张图风格都不一样读者反馈每看一张都要重新适应。后来我定了一套规范核心服务用蓝色圆角矩形数据存储用绿色圆柱外部系统用灰色直角矩形数据流用实线箭头控制流用虚线箭头。统一之后整套图的可读性提升明显。6. 协作与维护图不是画完就结束6.1 让图进版本控制而不是躺在某个人的电脑里图的最大问题不是画得不好而是找不到最新版。我见过太多团队一张架构图有七八个版本散落在不同人的电脑里讨论时各说各的。解决办法是让图的源文件进版本控制。如果用文本式工具源文件本身就是文本天然适合版本控制。如果用拖拽式工具至少要把导出的图和源文件一起放进共享位置并约定命名规范。命名规范我推荐主题-版本-日期的格式比如系统架构-v3-20240115。这样一眼能看出哪个是最新的。6.2 图例和说明文档让图能独立存活一张图如果离开了解说就没人看得懂那它的价值会大打折扣。所以重要的图要配图例和简短说明。图例解释符号和颜色的含义说明文档解释图的背景和结论。这两样东西不用很长但要放在图附近方便查阅。我有个习惯在图的下方用一两句话写这张图想说明什么。别小看这一两句话它能帮读者快速抓住重点也能帮未来的自己回忆当时的思路。6.3 定期审视过期的图比没有图更危险图会过期。系统改了图没改读者按图理解就会出错。所以要有定期审视的机制。我的做法是给每张重要的图标注最后更新日期和负责人。每次系统有重大变更时同步检查相关图是否需要更新。如果一张图超过半年没更新就要主动确认它是否还有效。注意过期的图比没有图更危险因为它会给人信息是准确的的错觉。7. 几个我反复验证过的实操技巧7.1 先画丑的再画美的很多人卡在画不好看上迟迟不动手。我的建议是先画丑的把逻辑理顺再美化。逻辑没理顺就追求美观等于在错误的地基上盖房子。先用最粗糙的方式把元素和关系画出来确认逻辑没问题再花时间调整视觉。这样效率最高返工最少。7.2 用陌生人测试检验图的清晰度图画的怎么样自己说了不算。找个不了解背景的同事让他看图说一遍理解的内容。如果他说得跟你想表达的一致图就合格了如果他说偏了说明图有问题。这个测试我用了很多次每次都能发现盲点。自己看自己的图会自动脑补缺失的信息但陌生人不会。7.3 保存半成品别一次画完画图是个迭代过程一次画完的图往往不是最好的。我的习惯是画到一半保存一版换个思路再画一版最后对比选最好的。特别是复杂的图第一版通常是把所有想到的都放进去第二版开始做减法第三版才接近最终形态。保留中间版本方便回溯和对比。7.4 建立自己的图形素材库画得多了会发现很多元素是重复的数据库、消息队列、用户、外部系统……与其每次重画不如建一个素材库把常用元素存起来下次直接复用。素材库不仅省时间还能保证一致性——同一个概念永远用同一个图形。我用文本式工具时会把常用元素定义成可复用的片段用拖拽式工具时会维护一个模板文件新图从模板开始画。7.5 导出前一定要检查的三件事导出是最后一步也是最容易出问题的一步。我每次导出前都会检查三件事第一文字是否清晰。放大到200%看文字边缘是否模糊。模糊就提高导出分辨率或改用矢量格式。第二颜色是否准确。不同设备显示颜色有差异导出后换个屏幕看看确认颜色没有偏得离谱。第三边界是否完整。有没有元素被裁掉有没有留白过多。导出时设置好画布边界别让图缺胳膊少腿。这三件事花不了两分钟但能避免大量返工。8. 关于diagram-design这件事我最后想说的画图这件事工具和技巧都是次要的核心是想清楚。想清楚图给谁看、要说明什么、重点在哪里剩下的都是执行问题。我见过用最简陋工具画出极清晰图的人也见过用最专业工具画出没人看得懂的图的人差别就在想没想清楚。如果你刚开始接触diagram-design我的建议是从小图开始练。别一上来就画几十个元素的系统图先画三五个元素的流程图把对齐、间距、颜色、标注这些基本功练熟。画得多了自然就有感觉了。另外别怕改。图是改出来的不是一次画成的。我画过一张架构图前后改了十几版每一版都比上一版清晰一点。改的过程就是思考深化的过程别嫌麻烦。最后分享一个我最近在用的方法画完图之后把它放一晚上第二天再看。隔了一夜你会用更客观的眼光审视它很多当时没发现的问题会自己跳出来。这个方法对写文档、写代码同样有效本质是给自己一个抽离的机会。
阅读完成 · 觉得有帮助？
