1. 從diagram-design這個(gè)標(biāo)題能讀出什么第一次看到diagram-design這個(gè)標(biāo)題我的直覺是這不是一個(gè)具體工具的名字而是一類工作的統(tǒng)稱——圍繞圖做設(shè)計(jì)。圖可以是流程圖、架構(gòu)圖、時(shí)序圖、狀態(tài)機(jī)圖、思維導(dǎo)圖、數(shù)據(jù)流圖甚至是手繪風(fēng)格的概念草圖。標(biāo)題里沒(méi)有限定領(lǐng)域也沒(méi)有指定工具這恰恰說(shuō)明它指向的是一個(gè)通用能力把抽象的邏輯關(guān)系、系統(tǒng)結(jié)構(gòu)、業(yè)務(wù)流程用可視化的方式表達(dá)清楚。很多人第一次接觸畫圖這件事會(huì)覺得它是個(gè)體力活——拖拖拽拽、對(duì)齊連線、調(diào)調(diào)顏色就完事了。但真正做過(guò)復(fù)雜系統(tǒng)設(shè)計(jì)的人都知道圖的質(zhì)量直接決定了溝通效率。一張好的架構(gòu)圖能讓新人在五分鐘內(nèi)理解系統(tǒng)邊界一張?jiān)愀獾膱D能讓團(tuán)隊(duì)開三小時(shí)的會(huì)還在爭(zhēng)論這個(gè)箭頭到底代表什么。所以diagram-design這個(gè)標(biāo)題背后真正要解決的不是怎么畫而是怎么把復(fù)雜信息壓縮成一張能被正確理解的圖。這篇文章適合三類人看第一類是需要頻繁輸出技術(shù)圖但總覺得畫出來(lái)不夠清晰的工程師第二類是要給非技術(shù)角色講清楚系統(tǒng)邏輯的產(chǎn)品或項(xiàng)目人員第三類是對(duì)可視化表達(dá)有興趣、想建立一套自己畫圖方法論的人。我會(huì)從設(shè)計(jì)原則、工具選型、實(shí)操流程、常見坑幾個(gè)角度展開盡量把為什么這樣畫講透而不是只給一堆模板。2. 畫圖之前先想清楚圖到底為誰(shuí)服務(wù)2.1 圖的三種讀者決定了三種畫法我踩過(guò)最大的一個(gè)坑就是曾經(jīng)用同一張架構(gòu)圖去應(yīng)付三個(gè)不同的場(chǎng)合給領(lǐng)導(dǎo)匯報(bào)、給開發(fā)講解、給運(yùn)維交接。結(jié)果三個(gè)場(chǎng)合的人都不滿意。領(lǐng)導(dǎo)覺得太細(xì)開發(fā)覺得太粗運(yùn)維覺得缺關(guān)鍵信息。后來(lái)我才明白圖不是客觀真理它是針對(duì)特定讀者的信息壓縮包。讀者不同壓縮策略就完全不同。給決策者看的圖核心是邊界和關(guān)系。他們不關(guān)心你用了什么消息隊(duì)列、分幾個(gè)分片他們關(guān)心的是這個(gè)系統(tǒng)跟哪些外部系統(tǒng)有交互、數(shù)據(jù)從哪來(lái)到哪去、出問(wèn)題的時(shí)候影響面有多大。所以這類圖要克制細(xì)節(jié)用大色塊區(qū)分模塊用粗箭頭表示主數(shù)據(jù)流把次要的調(diào)用關(guān)系弱化甚至省略。給開發(fā)者看的圖核心是接口和時(shí)序。他們需要知道模塊之間通過(guò)什么協(xié)議通信、調(diào)用順序是什么、異常分支怎么處理。這類圖適合用時(shí)序圖或帶標(biāo)注的流程圖把關(guān)鍵參數(shù)、超時(shí)設(shè)置、重試策略都標(biāo)出來(lái)。我習(xí)慣在時(shí)序圖旁邊加一個(gè)異常路徑的小圖專門畫失敗重試和降級(jí)邏輯這個(gè)習(xí)慣幫我省了很多口頭解釋。給運(yùn)維看的圖核心是部署和依賴。他們關(guān)心的是服務(wù)部署在哪些節(jié)點(diǎn)、依賴哪些中間件、監(jiān)控指標(biāo)從哪采集、故障時(shí)先看哪個(gè)面板。這類圖適合用部署圖或網(wǎng)絡(luò)拓?fù)鋱D把 IP 段、端口、健康檢查路徑都標(biāo)清楚。一個(gè)實(shí)用的判斷方法畫圖之前先問(wèn)自己這張圖給誰(shuí)看他看完之后要做什么決定。如果答不上來(lái)說(shuō)明你還沒(méi)想清楚先別打開畫圖工具。2.2 一張圖只講一件事新手最容易犯的錯(cuò)是想在一張圖里塞下所有信息。我見過(guò)一張系統(tǒng)全景圖上面同時(shí)畫了業(yè)務(wù)流程圖、數(shù)據(jù)流、部署拓?fù)?、監(jiān)控告警密密麻麻像電路板。作者很得意覺得信息量大但讀者根本找不到入口。我的經(jīng)驗(yàn)是一張圖只回答一個(gè)問(wèn)題。如果一個(gè)問(wèn)題需要多個(gè)視角才能說(shuō)清就拆成多張圖然后用一張索引圖把它們串起來(lái)。比如描述一個(gè)訂單系統(tǒng)我會(huì)拆成四張訂單狀態(tài)流轉(zhuǎn)圖回答訂單有哪些狀態(tài)、怎么流轉(zhuǎn)、下單時(shí)序圖回答一次下單經(jīng)過(guò)哪些服務(wù)、部署拓?fù)鋱D回答這些服務(wù)部署在哪、數(shù)據(jù)模型圖回答訂單數(shù)據(jù)怎么存。每張圖都簡(jiǎn)單但合起來(lái)信息完整。拆圖的好處不只是清晰還在于可維護(hù)。系統(tǒng)改了某個(gè)流程我只需要更新對(duì)應(yīng)的那一張圖不用動(dòng)其他三張。如果全塞在一張圖里改一處就要重新調(diào)整全局布局成本極高。2.3 先定圖例再畫內(nèi)容這個(gè)習(xí)慣我是從一位做數(shù)據(jù)可視化的前輩那里學(xué)來(lái)的。他的做法是任何一張正式圖先在角落畫一個(gè)圖例區(qū)定義清楚每種形狀、每種顏色、每種線型代表什么。比如實(shí)線代表同步調(diào)用、虛線代表異步消息、紅色代表失敗路徑、藍(lán)色代表正常路徑。聽起來(lái)很基礎(chǔ)但實(shí)際工作中大量圖是沒(méi)有圖例的。結(jié)果就是讀者靠猜這個(gè)虛線框是可選模塊還是外部系統(tǒng)這個(gè)菱形是判斷還是數(shù)據(jù)存儲(chǔ)一旦讀者開始猜圖的溝通價(jià)值就大打折扣。圖例還有一個(gè)隱藏好處它逼你在畫之前統(tǒng)一語(yǔ)義。很多時(shí)候我們畫到一半才發(fā)現(xiàn)前面用圓形表示服務(wù)后面又用矩形表示服務(wù)風(fēng)格不一致。如果先定圖例這種問(wèn)題在動(dòng)筆前就解決了。3. 工具選型別在工具上糾結(jié)太久3.1 三類工具的適用邊界關(guān)于畫圖工具我的態(tài)度很明確工具不重要重要的是你能不能快速改。因?yàn)閳D幾乎一定要改需求變了要改、系統(tǒng)演進(jìn)要改、讀者反饋要改。如果一個(gè)工具改起來(lái)很痛苦你就不愿意改圖就會(huì)慢慢過(guò)期最后沒(méi)人看。我把常見工具分成三類。第一類是代碼生成類用文本描述圖工具渲染成圖片。這類工具的最大優(yōu)勢(shì)是版本可控、diff 清晰、改起來(lái)快。適合架構(gòu)圖、時(shí)序圖、狀態(tài)機(jī)圖這類結(jié)構(gòu)性強(qiáng)、需要頻繁迭代的圖。缺點(diǎn)是樣式調(diào)整不夠靈活想要精細(xì)的視覺設(shè)計(jì)比較費(fèi)勁。第二類是拖拽繪制類就是傳統(tǒng)的畫圖軟件。優(yōu)勢(shì)是自由度高想怎么擺就怎么擺適合概念草圖、需要精細(xì)排版的匯報(bào)圖。缺點(diǎn)是改起來(lái)麻煩而且不同人畫出來(lái)的風(fēng)格很難統(tǒng)一。第三類是白板協(xié)作類適合頭腦風(fēng)暴階段的快速草圖。優(yōu)勢(shì)是多人實(shí)時(shí)協(xié)作適合討論。缺點(diǎn)是正式輸出時(shí)通常需要重新整理因?yàn)榘装迳系膱D往往比較隨意。我的實(shí)際組合是討論階段用白板類工具快速畫草圖確定結(jié)構(gòu)后用代碼生成類工具產(chǎn)出正式圖只有需要對(duì)外匯報(bào)、對(duì)視覺要求高的場(chǎng)合才用拖拽類工具精修。這樣既保證了迭代速度又保證了正式輸出的質(zhì)量。3.2 為什么我優(yōu)先推薦代碼生成類很多人覺得用代碼畫圖很反直覺——畫圖不是應(yīng)該所見即所得嗎但我用了幾年之后越來(lái)越傾向于代碼生成。原因有三個(gè)。第一改起來(lái)真的快。系統(tǒng)加了一個(gè)服務(wù)我只需要在文本里加一行重新渲染就完事了不用手動(dòng)調(diào)整周圍所有元素的位置。拖拽工具里加一個(gè)節(jié)點(diǎn)往往要重新對(duì)齊一整片區(qū)域。第二版本管理友好。文本文件可以進(jìn)代碼倉(cāng)庫(kù)每次改動(dòng)都有記錄誰(shuí)在什么時(shí)候改了什么一目了然。圖片文件做不到這一點(diǎn)你只能看到圖變了但不知道變了哪里。第三強(qiáng)制你關(guān)注結(jié)構(gòu)而非樣式。用代碼畫圖時(shí)你描述的是A 調(diào)用 BB 依賴 C而不是A 這個(gè)框放在 B 左邊顏色調(diào)成淺藍(lán)。這種約束反而讓你更專注于邏輯本身畫出來(lái)的圖通常更清晰。當(dāng)然代碼生成類工具也有短板。比如復(fù)雜的嵌套布局、非標(biāo)準(zhǔn)的視覺元素實(shí)現(xiàn)起來(lái)比較別扭。所以我的建議是結(jié)構(gòu)性的圖用代碼生成視覺性的圖用拖拽工具不要強(qiáng)求一個(gè)工具解決所有問(wèn)題。3.3 一個(gè)容易被忽略的選型維度協(xié)作成本選工具時(shí)大家通?？垂δ艿艺J(rèn)為協(xié)作成本更關(guān)鍵。所謂協(xié)作成本就是別人要改你這張圖需要付出多少學(xué)習(xí)成本。如果團(tuán)隊(duì)里只有你一個(gè)人會(huì)用某個(gè)冷門工具那這張圖就成了你的私有資產(chǎn)你一休假就沒(méi)人能改。反過(guò)來(lái)如果工具足夠普及、語(yǔ)法足夠簡(jiǎn)單團(tuán)隊(duì)里其他人能快速上手圖的維護(hù)就不再依賴單個(gè)人。所以我在團(tuán)隊(duì)里推工具時(shí)會(huì)優(yōu)先選語(yǔ)法簡(jiǎn)單、文檔齊全、上手快的。哪怕功能少一點(diǎn)只要大家都能改就比功能強(qiáng)大但只有一個(gè)人會(huì)用要好。這個(gè)原則在人員流動(dòng)頻繁的團(tuán)隊(duì)里尤其重要。4. 一套可復(fù)用的畫圖流程4.1 第一步用一句話寫下圖的主題聽起來(lái)很傻但這一步能過(guò)濾掉大量無(wú)效工作。如果我不能用一句話說(shuō)清這張圖要表達(dá)什么那說(shuō)明我還沒(méi)想清楚畫出來(lái)大概率是廢圖。這句話的格式我習(xí)慣用這張圖展示 X 在 Y 條件下的 Z。比如這張圖展示訂單服務(wù)在正常下單場(chǎng)景下的調(diào)用時(shí)序、這張圖展示系統(tǒng)與外部支付渠道的邊界關(guān)系。有了這句話后面所有內(nèi)容都要服務(wù)于它不相關(guān)的信息一律砍掉。4.2 第二步列出所有元素先不畫關(guān)系確定主題后我會(huì)先把圖里要出現(xiàn)的所有元素列出來(lái)——有哪些服務(wù)、哪些數(shù)據(jù)存儲(chǔ)、哪些外部系統(tǒng)、哪些角色。這一步只列清單不畫連線。列清單的好處是防止遺漏。畫圖時(shí)很容易畫著畫著發(fā)現(xiàn)哎這個(gè)服務(wù)忘了然后臨時(shí)插入導(dǎo)致布局混亂。先列全再統(tǒng)一布局效率高很多。列完之后我會(huì)做一次篩選哪些元素是核心哪些是次要。核心元素放在視覺中心次要元素放在邊緣。這個(gè)主次關(guān)系直接決定了讀者第一眼看哪里。4.3 第三步先畫主干再補(bǔ)分支布局時(shí)我遵循主干優(yōu)先原則。先把最主要的幾條關(guān)系畫出來(lái)比如主調(diào)用鏈、主數(shù)據(jù)流確保主干清晰。然后再補(bǔ)異常分支、次要依賴、監(jiān)控采集這些輔助信息。這樣做的原因是讀者的注意力是有限的如果主干和分支混在一起畫讀者很難分辨哪些是重點(diǎn)。先畫主干相當(dāng)于給讀者一條閱讀路徑他順著主干看下去再根據(jù)需要看分支。我見過(guò)很多圖的問(wèn)題就在于沒(méi)有主干——所有連線看起來(lái)同等重要讀者不知道從哪看起。這種圖通常是因?yàn)樽髡邲](méi)有區(qū)分主次把所有關(guān)系都平鋪了。4.4 第四步加標(biāo)注但只加必要的標(biāo)注是圖的注釋能大幅提升信息密度但加多了會(huì)變成噪音。我的原則是只標(biāo)注讀者會(huì)問(wèn)的問(wèn)題。比如時(shí)序圖里我會(huì)標(biāo)注關(guān)鍵的超時(shí)時(shí)間、重試次數(shù)、冪等鍵。因?yàn)檫@些是讀者看的時(shí)候一定會(huì)問(wèn)的這個(gè)調(diào)用失敗了怎么辦會(huì)不會(huì)重復(fù)下單提前標(biāo)出來(lái)就不用口頭解釋了。但像這個(gè)服務(wù)用什么語(yǔ)言寫的這個(gè)數(shù)據(jù)庫(kù)是什么版本這類信息除非跟圖要表達(dá)的主題直接相關(guān)否則不加。加了只會(huì)讓圖變亂。4.5 第五步找人試讀收集看不懂的點(diǎn)圖畫完之后我會(huì)找一個(gè)沒(méi)參與設(shè)計(jì)的人試讀讓他說(shuō)出他理解的內(nèi)容然后對(duì)比我想表達(dá)的內(nèi)容。差異點(diǎn)就是需要修改的地方。這一步非常關(guān)鍵但很多人省略了。因?yàn)樽髡邔?duì)自己的圖太熟悉了會(huì)自動(dòng)腦補(bǔ)缺失的信息看不出問(wèn)題。只有沒(méi)背景的人才能暴露真正的歧義。試讀時(shí)我通常問(wèn)三個(gè)問(wèn)題這張圖在講什么你覺得哪個(gè)部分是核心有沒(méi)有你看不懂的地方根據(jù)回答調(diào)整通常改兩三版就能達(dá)到自解釋的程度。5. 那些年我踩過(guò)的畫圖坑5.1 坑一追求好看犧牲清晰剛工作那會(huì)兒我特別在意圖的顏值——配色要高級(jí)、陰影要柔和、圓角要統(tǒng)一。結(jié)果花了兩小時(shí)調(diào)樣式圖是好看了但邏輯一團(tuán)糟。后來(lái)被一位前輩點(diǎn)醒圖的第一目標(biāo)是讓人看懂不是讓人夸好看?，F(xiàn)在我畫圖樣式一律從簡(jiǎn)黑白灰為主最多用兩三種顏色區(qū)分模塊形狀只用矩形和圓角矩形連線只用直線和折線。把省下來(lái)的時(shí)間花在邏輯梳理上圖的溝通效果反而更好。當(dāng)然對(duì)外匯報(bào)的圖可以適當(dāng)美化但前提是邏輯已經(jīng)清晰。美化是錦上添花不是雪中送炭。5.2 坑二連線交叉太多讀者迷路連線交叉是畫圖里最影響可讀性的問(wèn)題之一。我早期的圖經(jīng)常像蜘蛛網(wǎng)線到處飛讀者要順著線找半天才能找到目標(biāo)。減少交叉的方法有幾個(gè)。一是調(diào)整元素順序把有調(diào)用關(guān)系的元素放在相鄰位置。二是用跳線符號(hào)表示線交叉但不連接。三是把復(fù)雜關(guān)系拆成多張圖不要硬塞在一張里。還有一個(gè)技巧是分層把不同層級(jí)的東西畫在不同水平線上上層調(diào)用下層這樣連線大多是垂直的交叉自然就少了。5.3 坑三圖更新不及時(shí)變成歷史文物這是最隱蔽也最致命的坑。系統(tǒng)一直在演進(jìn)但圖沒(méi)人更新半年后圖上的服務(wù)已經(jīng)下線了新加的服務(wù)沒(méi)畫上去。這時(shí)候圖不僅沒(méi)用還會(huì)誤導(dǎo)人。我的應(yīng)對(duì)方法是把圖納入變更流程。每次系統(tǒng)有架構(gòu)級(jí)改動(dòng)必須同步更新對(duì)應(yīng)的圖跟代碼一起提交。這樣圖就跟著系統(tǒng)一起演進(jìn)不會(huì)過(guò)期。另外我會(huì)在圖里標(biāo)注最后更新時(shí)間和對(duì)應(yīng)版本。讀者看到時(shí)間比較久就知道要謹(jǐn)慎參考主動(dòng)去確認(rèn)最新情況。5.4 坑四一個(gè)人悶頭畫不跟讀者確認(rèn)我曾經(jīng)花了一整天畫了一張自認(rèn)為很完美的架構(gòu)圖拿去匯報(bào)時(shí)被領(lǐng)導(dǎo)問(wèn)這個(gè)模塊跟那個(gè)模塊是什么關(guān)系我才發(fā)現(xiàn)我默認(rèn)大家都知道的關(guān)系領(lǐng)導(dǎo)并不知道。后來(lái)我養(yǎng)成了一個(gè)習(xí)慣畫圖前先跟主要讀者確認(rèn)你希望這張圖回答什么問(wèn)題。有時(shí)候讀者要的跟我以為的完全不一樣。提前對(duì)齊比畫完再返工劃算得多。6. 讓圖自解釋的幾個(gè)細(xì)節(jié)技巧6.1 用命名傳遞信息元素命名不要用服務(wù)A模塊B這種無(wú)意義代號(hào)直接用能表達(dá)職責(zé)的名字比如訂單創(chuàng)建服務(wù)庫(kù)存扣減服務(wù)。讀者看到名字就知道它是干什么的不用額外解釋。如果名字太長(zhǎng)可以用縮寫但要在圖例里說(shuō)明。比如OMS代表訂單管理服務(wù)第一次出現(xiàn)時(shí)標(biāo)注全稱。6.2 用方向表達(dá)語(yǔ)義箭頭方向要統(tǒng)一語(yǔ)義。我習(xí)慣用箭頭指向被調(diào)用方表示調(diào)用關(guān)系箭頭指向數(shù)據(jù)流向方表示數(shù)據(jù)流。同一張圖里不要混用兩種語(yǔ)義否則讀者會(huì)混淆。如果一張圖里既有調(diào)用又有數(shù)據(jù)流我會(huì)用不同線型區(qū)分實(shí)線表示調(diào)用虛線表示數(shù)據(jù)流。并在圖例里寫清楚。6.3 用分組表達(dá)邊界系統(tǒng)邊界、團(tuán)隊(duì)邊界、部署邊界都可以用分組框表達(dá)。分組框能幫讀者快速理解哪些東西是一伙的。分組不要嵌套太深兩層就夠了。三層以上的嵌套會(huì)讓圖變得難以閱讀這時(shí)候應(yīng)該考慮拆圖。6.4 用留白引導(dǎo)視線留白不是浪費(fèi)空間而是引導(dǎo)讀者視線的工具。核心元素周圍留出足夠空白讀者自然會(huì)先看那里。如果所有元素都擠在一起讀者會(huì)感到壓迫不知道從哪看起。我畫圖時(shí)會(huì)在核心模塊周圍留出至少一個(gè)元素寬度的空白邊緣的次要元素可以緊湊一些。這種疏密對(duì)比能有效突出重點(diǎn)。7. 從畫圖到設(shè)計(jì)圖的思維轉(zhuǎn)變7.1 圖是設(shè)計(jì)工具不是記錄工具很多人把畫圖當(dāng)成記錄已經(jīng)想好的東西但我的體會(huì)是畫圖本身就是設(shè)計(jì)過(guò)程。當(dāng)你試圖把邏輯畫出來(lái)時(shí)很多之前沒(méi)想清楚的問(wèn)題會(huì)暴露出來(lái)——這個(gè)分支怎么處理這個(gè)循環(huán)會(huì)不會(huì)死鎖這個(gè)依賴是不是多余所以我現(xiàn)在畫圖往往在系統(tǒng)還沒(méi)完全定型時(shí)就開始畫。畫的過(guò)程就是推演的過(guò)程畫完圖設(shè)計(jì)也清晰了。圖不是設(shè)計(jì)的產(chǎn)物而是設(shè)計(jì)的一部分。7.2 圖是溝通契約不是個(gè)人表達(dá)一張被團(tuán)隊(duì)接受的圖實(shí)際上是一份溝通契約——大家約定用這張圖作為討論的基礎(chǔ)。這意味著圖不能太個(gè)人化要符合團(tuán)隊(duì)的共同理解。比如團(tuán)隊(duì)習(xí)慣用某種顏色表示某種含義你就不要為了好看改成別的顏色。團(tuán)隊(duì)習(xí)慣某種布局方式你就盡量沿用。圖的個(gè)性應(yīng)該體現(xiàn)在邏輯的清晰度上而不是視覺的標(biāo)新立異上。7.3 圖是活的資產(chǎn)需要持續(xù)投入最后一點(diǎn)體會(huì)圖不是畫完就完事的它需要持續(xù)維護(hù)。一個(gè)團(tuán)隊(duì)如果能把核心圖維護(hù)好新人的上手成本會(huì)大幅降低跨團(tuán)隊(duì)溝通的效率也會(huì)提升。所以我會(huì)建議團(tuán)隊(duì)指定圖負(fù)責(zé)人專門負(fù)責(zé)核心圖的更新和審查。這個(gè)投入看起來(lái)是額外的但長(zhǎng)期看回報(bào)很高。一張維護(hù)良好的架構(gòu)圖能省下無(wú)數(shù)次口頭解釋和會(huì)議討論。8. 我個(gè)人的幾個(gè)實(shí)操習(xí)慣最后分享幾個(gè)我一直在用的小習(xí)慣都是踩坑之后總結(jié)出來(lái)的。第一個(gè)習(xí)慣畫圖前先在紙上畫草圖。紙上的自由度最高改起來(lái)最快適合快速試錯(cuò)。確定結(jié)構(gòu)后再用工具正式畫效率比直接在工具里改高很多。第二個(gè)習(xí)慣給圖起一個(gè)描述性的文件名。比如訂單服務(wù)-正常下單時(shí)序-2024版而不是圖1新建文件。文件名本身就是一種文檔方便日后查找。第三個(gè)習(xí)慣重要圖導(dǎo)出兩種格式一種矢量圖用于放大查看一種位圖用于快速預(yù)覽。矢量圖在縮放時(shí)不會(huì)模糊適合正式場(chǎng)合位圖加載快適合日常溝通。第四個(gè)習(xí)慣定期回顧舊圖。每隔一段時(shí)間翻翻之前畫的圖看看哪些已經(jīng)過(guò)期、哪些還能用。這個(gè)過(guò)程也能幫你發(fā)現(xiàn)自己設(shè)計(jì)思路的演進(jìn)挺有意思的。畫圖這件事說(shuō)到底是一種把復(fù)雜變簡(jiǎn)單的能力。工具會(huì)變、樣式會(huì)變但讓讀者快速正確理解這個(gè)目標(biāo)不會(huì)變。把精力花在邏輯梳理和讀者視角上比花在工具技巧上回報(bào)高得多。