企业官网建设流程全解析

1. 从一张草图到一套系统：diagram-design 到底在解决什么问题

第一次听到 diagram-design 这个词，很多人会下意识觉得它只是“画图”的另一种说法。但真正在项目里被图表折磨过的人知道，画图只是冰山一角，水面下藏着的是一整套关于信息结构、视觉语言和协作流程的设计系统。diagram-design 的核心，不是教你用某个工具拖几个方框连几条线，而是把“图”当成一种需要被设计的产品来对待——它要有信息层级、有视觉规范、有复用逻辑，还要能在不同角色之间顺畅传递。

我最早接触这个概念，是在一个跨平台系统的重构项目里。当时团队里有人用流程图，有人用架构图，有人用状态机图，每个人画出来的风格都不一样：圆角半径不同、配色不同、连箭头的粗细都能吵起来。更麻烦的是，同一份逻辑在不同图里表达不一致，评审时大家对着三张图各说各话。后来我们意识到，问题不在于谁画得好看，而在于缺少一套统一的图表设计语言。diagram-design 要解决的，正是这种“图出多门”的混乱。

它适合谁？如果你只是偶尔画一张示意图发群里，可能感受不深。但只要你参与过需要多人协作、需要长期维护、需要反复迭代的项目，你就会明白一套图表设计规范有多重要。产品经理用它来统一需求文档里的流程表达，架构师用它来规范系统拓扑的视觉层级，技术写作者用它来保证文档配图的一致性，甚至运营同学也能用它来设计活动路径图。它不挑行业，只挑场景——凡是需要“把复杂关系讲清楚”的地方，diagram-design 就有用武之地。

这篇文章我会从实际项目出发，拆解 diagram-design 的整体设计思路、核心细节、实操流程和踩坑经验。不会只讲理论，而是把我在多个项目里沉淀下来的具体做法、参数选择和判断逻辑都摊开来说。你可以把它当成一份可以直接抄作业的参考手册，也可以当成一个从业者的复盘笔记。

2. 内容整体设计与思路拆解

2.1 为什么图表需要“设计”而不是“绘制”

很多人把画图和设计混为一谈，觉得只要把信息放上去就算完成了。但图表设计的本质，是信息架构的视觉化翻译。一张好的图，读者应该在 3 秒内抓住主干，10 秒内理解分支，30 秒内能复述核心逻辑。如果做不到，那这张图就只是“画了”，而不是“设计过”。

我在实际项目里总结过一个判断标准：把图给一个没参与过讨论的人看，如果他能在不问你任何问题的情况下说出“这个系统大概是怎么运转的”，那这张图的设计就是合格的。反之，如果对方第一句话是“这个箭头是什么意思”，那说明视觉语言没有自解释能力，设计是失败的。

diagram-design 的思路，是把图表拆成四个层次来设计：

• 信息层：哪些是主干信息，哪些是辅助信息，哪些是异常分支。主干必须最醒目，辅助要弱化但不能消失，异常分支要有明确的视觉标识但不能抢戏。
• 结构层：节点之间的连接关系是顺序、分支、循环还是并行。不同的关系类型需要不同的视觉表达，不能全用同一种箭头糊弄过去。
• 视觉层：颜色、形状、线型、字号、间距。这一层最容易过度设计，也最容易失控。我的原则是：视觉元素只用来区分“类别”和“层级”，不用来装饰。
• 交互层：如果图是可交互的，还要考虑悬停、点击、展开收起的行为逻辑。静态图则要考虑打印和缩放后的可读性。

这四个层次不是孤立的，而是层层递进。信息层没理清，结构层就是乱的；结构层没定好，视觉层怎么调都别扭。很多团队一上来就纠结配色，其实是跳过了前两层，最后只能靠视觉堆砌来掩盖逻辑混乱。

2.2 方案选型：为什么我最终放弃了“万能模板”

刚开始做图表规范时，我尝试过找一套“万能模板”，希望一套样式能覆盖所有场景。结果发现这条路走不通。流程图需要横向展开，架构图需要纵向分层，状态机图需要环形布局，时序图需要纵向时间轴。强行用同一套模板，只会让每种图都变得别扭。

后来我调整了策略：建立一套“基础设计令牌”，再针对不同图类型做“变体”。基础令牌包括：

这套令牌的好处是，不同图类型可以共享同一套底层变量，但在布局和组合方式上各自独立。比如流程图用横向布局加圆角矩形，架构图用纵向分层加直角矩形，状态机图用环形布局加圆形节点。视觉上它们是一家人，但结构上各司其职。

注意：设计令牌的命名要语义化，不要用“蓝色”“大号”这种描述性命名，而要用“主色”“标题字号”这种功能性命名。否则换一套配色时，你会发现自己要改几百个地方。

2.3 工具选型的取舍逻辑

工具选型上，我试过不少方案。早期用通用绘图工具，灵活但难以版本化；后来用代码生成图表的方案，可版本化但学习成本高；再后来用声明式图表工具，平衡了灵活性和可维护性。最终我的选择是：用声明式语法定义图表结构，用设计令牌控制视觉输出，用版本控制管理变更。

为什么这么选？因为图表和代码一样，是需要迭代的。今天加一个节点，明天改一条连线，后天调整一个分支。如果每次修改都要手动拖拽，不仅效率低，还容易漏改。声明式的好处是，你改的是“逻辑描述”，而不是“像素位置”。布局引擎会自动处理位置计算，你只需要关心信息本身。

当然，声明式也有代价。它不适合做高度定制化的视觉设计，比如那种需要精确到像素的艺术化图表。但对于绝大多数技术图表来说，清晰和一致比花哨更重要。我的判断标准是：如果一张图需要超过 5 分钟来调整视觉细节，那它就不值得用声明式；如果一张图需要反复修改逻辑结构，那它就不值得用手动拖拽。

3. 核心细节解析与实操要点

3.1 信息层级的设计：让读者第一眼看到重点

信息层级是图表设计的灵魂。我见过太多图，所有节点一样大、一样粗、一样颜色，读者根本不知道从哪里看起。好的信息层级应该像一条引导线，牵着读者的眼睛走。

我的做法是给每个节点定义一个“权重值”，权重决定它的视觉表现：

• 权重 3（主干）：最大字号、最深颜色、最粗边框。通常是核心流程的主路径节点。
• 权重 2（分支）：中等字号、中等颜色、常规边框。通常是条件分支或辅助流程。
• 权重 1（注释）：最小字号、最浅颜色、无边框或虚线边框。通常是补充说明或异常处理。

权重值不是拍脑袋定的，而是根据“这个节点在业务逻辑中的重要性”来评估。评估维度包括：出现频率、影响范围、是否可省略。出现频率高且影响范围大的节点，权重就高；只在极端情况下出现的节点，权重就低。

实操心得：权重值不要超过 3 级。超过 3 级后，读者很难区分“权重 2”和“权重 3”的差别，反而增加了认知负担。如果确实需要更多层级，考虑拆成两张图。

3.2 连接关系的视觉表达：箭头不是随便画的

连接关系是图表里最容易被忽视的部分。很多人画箭头就是一条线加一个三角，从来不区分关系类型。但在复杂系统里，不同的连接关系需要不同的视觉表达。

我通常把连接关系分为四类：

这四类关系的视觉差异要足够明显，远看就能区分。如果条件关系和顺序关系都是实线，读者就得凑近看箭头样式，体验很差。

另外，箭头的方向也要有讲究。主流程从左到右或从上到下，符合阅读习惯；回滚路径从右到左或从下到上，形成视觉上的“逆向感”；循环路径用弧形箭头，避免直线交叉。

3.3 颜色使用的克制原则：三种颜色足够打天下

颜色是图表设计里最容易滥用的元素。我见过一张图用了十几种颜色，每个节点都不一样，结果读者根本记不住哪个颜色代表什么。颜色应该用来编码信息，而不是用来装饰。

我的原则是：一张图的主色不超过三种，加上中性色和警示色，总共不超过五种。具体分配如下：

• 主色：用于主干流程节点，占图面积的 60% 左右。
• 辅色：用于分支流程节点，占 30% 左右。
• 中性色：用于注释和背景，占 10% 左右。
• 警示色：仅用于异常节点，面积越小越有效。
• 强调色：仅用于当前焦点节点，如果图是交互式的。

颜色的选择上，我倾向于低饱和度、中明度的色系。高饱和度颜色虽然醒目，但大面积使用会让人视觉疲劳，而且打印出来容易糊成一团。低饱和度颜色更耐看，也更容易搭配。

注意：如果图表需要适配深色模式，颜色令牌要定义两套值。不要试图用一套颜色通吃，深色背景下的浅色和浅色背景下的深色，视觉重量完全不同。

3.4 布局算法的选择：为什么我最终用了分层布局

布局是图表设计里最耗时的部分。手动拖拽节点位置，不仅效率低，而且很难保证对齐和间距一致。我试过几种自动布局算法，最终选择了分层布局作为主力方案。

分层布局的核心逻辑是：根据节点之间的依赖关系，自动计算每个节点所在的层级，然后按层级排列。同一层级的节点水平对齐，不同层级的节点垂直分布。这种布局特别适合流程图和架构图，因为它天然表达了“先后”和“上下”的关系。

分层布局的关键参数有三个：

• 层间距：相邻层级之间的垂直距离。太小会显得拥挤，太大会显得松散。我的经验值是节点高度的 1.5 到 2 倍。
• 节点间距：同一层级内相邻节点的水平距离。通常是节点宽度的 0.5 到 1 倍。
• 对齐方式：左对齐、居中对齐还是右对齐。流程图通常用左对齐，架构图通常用居中对齐。

如果图中有循环依赖，分层布局会报错。这时候需要手动打断循环，或者换用力导向布局。力导向布局适合表达“关系网络”而不是“流程顺序”，比如微服务之间的调用关系图。

3.5 文字排版的可读性细节

图表里的文字排版，比正文排版更讲究。因为图表的阅读场景通常是“快速扫视”，而不是“逐字阅读”。所以文字必须做到：一眼能认出、不费劲能读完、不产生歧义。

我的排版规则如下：

• 字号：标题 16px，正文 13px，注释 11px。低于 11px 在打印时基本看不清。
• 行高：1.4 到 1.6 倍。太密会显得拥挤，太疏会显得松散。
• 字重：标题用中等字重，正文用常规字重，注释用细字重。不要用粗体，粗体在图表里显得笨重。
• 对齐：节点内文字左对齐，节点标题居中对齐。左对齐适合多行文本，居中对齐适合单行标题。
• 截断：如果文字太长，优先换行，其次缩小字号，最后才截断。截断时用省略号，并在注释里补充完整内容。

实操心得：中文和英文的排版规则不同。中文没有单词边界，换行时要注意不要把一个词拆开。英文要注意不要把一个单词拆到两行。如果图表工具不支持智能换行，手动加换行符。

4. 实操过程与核心环节实现

4.1 从零搭建一套图表设计系统

搭建一套图表设计系统，不是一上来就画图，而是先定义“设计令牌”。设计令牌是图表设计系统的基础变量，所有视觉表现都从这里派生。

第一步，定义颜色令牌。我通常从品牌色出发，派生出五个功能色：

:root { --diagram-color-primary: #3b82f6; --diagram-color-secondary: #8b5cf6; --diagram-color-neutral: #6b7280; --diagram-color-warning: #ef4444; --diagram-color-background: #f9fafb; }

第二步，定义字号令牌。字号不要用绝对值，用相对值，方便整体缩放：

:root { --diagram-font-size-title: 1.23rem; --diagram-font-size-body: 1rem; --diagram-font-size-caption: 0.85rem; }

第三步，定义间距令牌。间距用 4 的倍数，保证视觉节奏一致：

:root { --diagram-spacing-xs: 4px; --diagram-spacing-sm: 8px; --diagram-spacing-md: 16px; --diagram-spacing-lg: 32px; --diagram-spacing-xl: 64px; }

第四步，定义线型令牌。线型用来区分关系类型：

:root { --diagram-stroke-solid: 2px solid; --diagram-stroke-dashed: 2px dashed; --diagram-stroke-dotted: 2px dotted; }

这套令牌定义好之后，所有图表都从这里取值。换配色时只改令牌，不改图表。换字号时也只改令牌，不改图表。这就是设计系统的价值：一处修改，处处生效。

4.2 用声明式语法描述一张流程图

定义好令牌后，就可以用声明式语法描述图表了。我以一张“用户登录流程”为例，展示完整的描述过程。

diagram: type: flowchart direction: horizontal nodes: - id: start label: 开始 weight: 3 shape: rounded-rect - id: input label: 输入凭证 weight: 3 shape: rounded-rect - id: validate label: 校验凭证 weight: 3 shape: diamond - id: success label: 登录成功 weight: 3 shape: rounded-rect - id: fail label: 登录失败 weight: 1 shape: rounded-rect color: warning - id: retry label: 重试 weight: 2 shape: rounded-rect edges: - from: start to: input type: sequence - from: input to: validate type: sequence - from: validate to: success type: condition label: 通过 - from: validate to: fail type: condition label: 不通过 - from: fail to: retry type: exception - from: retry to: input type: loop

这段描述里，每个节点有 id、label、weight、shape 四个属性。weight 决定视觉权重，shape 决定节点形状。每条边有 from、to、type、label 四个属性。type 决定线型和箭头样式。

布局引擎会根据 direction 和节点依赖关系，自动计算位置。你不需要指定 x、y 坐标，只需要描述逻辑关系。这就是声明式的优势：你描述“是什么”，引擎决定“在哪里”。

4.3 参数计算：层间距和节点间距怎么定

层间距和节点间距不是随便定的，而是根据字号和节点尺寸计算出来的。我通常用以下公式：

• 层间距 = 节点高度 × 1.5 + 字号 × 2
• 节点间距 = 节点宽度 × 0.5 + 字号 × 1

假设节点高度是 48px，字号是 13px，那么层间距 = 48 × 1.5 + 13 × 2 = 72 + 26 = 98px。节点宽度是 160px，那么节点间距 = 160 × 0.5 + 13 × 1 = 80 + 13 = 93px。

这个公式的逻辑是：层间距要保证箭头有足够的空间，同时文字不会和箭头重叠。节点间距要保证相邻节点不会挤在一起，同时整体不会太松散。

如果图比较密集，可以适当缩小系数。比如层间距系数从 1.5 降到 1.2，节点间距系数从 0.5 降到 0.3。但不要低于 1.0 和 0.2，否则会显得拥挤。

注意：如果节点里有图标，层间距和节点间距要额外增加图标高度的 0.5 倍。图标比文字更占视觉空间，需要更多呼吸感。

4.4 实操现场：一次完整的图表迭代记录

我以一次真实的图表迭代为例，展示从初稿到终稿的完整过程。

初稿：所有节点权重都是 3，所有边都是实线，颜色用了五种。结果评审时大家说“看不出重点”。

第一次修改：把异常节点权重降到 1，把条件边改成虚线。评审时说“好一些了，但主干还是不够突出”。

第二次修改：把主干节点权重提到 3，分支节点权重降到 2，注释节点权重降到 1。颜色从五种减到三种。评审时说“清晰多了，但布局有点挤”。

第三次修改：调整层间距从 80px 到 98px，节点间距从 60px 到 93px。评审时说“可以了，通过”。

这次迭代让我意识到，图表设计和写代码一样，需要反复 review 和调整。初稿不可能完美，关键是要有明确的修改方向。我的修改方向始终围绕三个问题：重点是否突出、关系是否清晰、呼吸感是否足够。

4.5 版本控制与变更管理

图表和代码一样，需要版本控制。我用 Git 管理图表源文件，每次修改都提交 commit，commit message 写清楚改了什么、为什么改。

这样做的好处是：

• 可以回溯历史版本，看看某次修改前后的差异。
• 可以对比不同分支的图表，比如“简化版”和“详细版”。
• 可以在 PR 里 review 图表变更，像 review 代码一样。

如果图表是二进制格式（比如某些绘图工具的文件），版本控制会比较麻烦。所以我倾向于用文本格式描述图表，比如 YAML 或 JSON。文本格式的 diff 很清晰，一眼就能看出改了哪个节点、哪条边。

实操心得：图表源文件里不要写死颜色值和字号值，而是引用设计令牌。这样换主题时只需要改令牌文件，不需要改每个图表文件。令牌文件也要版本控制，和图表文件放在同一个仓库里。

5. 常见问题与排查技巧实录

5.1 图表太乱怎么办：从信息层开始排查

图表乱，通常不是视觉问题，而是信息问题。我的排查顺序是：

1. 节点太多：一张图超过 15 个节点，读者就很难记住。考虑拆成两张图，或者把次要节点折叠起来。
2. 关系太杂：如果节点之间的连线交叉超过 5 处，说明布局算法选错了。试试换布局方向，或者换布局算法。
3. 层级不清：如果所有节点看起来一样重要，说明权重值没有区分度。重新评估每个节点的权重。
4. 颜色太多：如果用了超过五种颜色，说明颜色在装饰而不是编码。删掉装饰性颜色，只保留功能性颜色。

排查时我通常会把图打印出来，用笔在纸上标记。屏幕上容易忽略的问题，打印出来一目了然。特别是连线交叉和文字重叠，打印后非常明显。

5.2 文字溢出和重叠：预防比修复更重要

文字溢出是图表设计里最常见的问题。预防的方法是在设计阶段就限制文字长度：

• 节点标题不超过 12 个中文字符。
• 节点正文不超过 30 个中文字符。
• 边标签不超过 6 个中文字符。

如果文字确实太长，优先换行，其次缩小字号，最后才截断。截断时用省略号，并在图下方的注释里补充完整内容。

如果已经出现了文字重叠，排查顺序是：

1. 检查节点宽度是否足够。节点宽度 = 最长文字宽度 + 内边距 × 2。
2. 检查字号是否太大。如果节点宽度已经最大，考虑缩小字号。
3. 检查布局参数是否合理。层间距和节点间距是否足够。
4. 检查是否有绝对定位的节点。绝对定位的节点不参与自动布局，容易和其他节点重叠。

注意：不同字体的文字宽度不同。中文字体通常比英文字体宽，衬线字体通常比无衬线字体宽。设计时要按最宽的情况预留空间。

5.3 颜色在打印时失真：提前做灰度测试

彩色图表在屏幕上很好看，打印成黑白后可能一团糟。特别是红色和绿色，在灰度模式下亮度接近，根本区分不出来。

我的做法是：设计完成后，把图转成灰度模式看一眼。如果灰度模式下还能区分不同类别，说明颜色设计是合格的。如果区分不出来，说明颜色只靠色相区分，没有靠明度区分。

改进方法是：让不同类别的颜色在明度上也有差异。比如主色用中明度，辅色用低明度，警示色用高明度。这样即使去掉色相，也能靠明度区分。

5.4 常见问题速查表

5.5 独家避坑技巧：我踩过的五个坑

第一个坑：过度依赖自动布局。自动布局虽然方便，但不是万能的。有些图需要手动微调，比如把某个节点稍微挪一下避免连线交叉。我的做法是：自动布局打底，手动微调收尾。但手动调整的参数要记录下来，下次重新生成时还能复现。

第二个坑：忽略深色模式。早期我只做了浅色模式的图表，后来产品要求支持深色模式，所有图表都要重新调色。教训是：设计令牌从一开始就定义两套值，浅色一套，深色一套。切换主题时只换令牌，不换图表。

第三个坑：字号用绝对值。早期我用 px 定义字号，后来需要整体缩放图表时，发现所有字号都要手动改。后来改用 rem，缩放时只改根字号，所有字号自动缩放。

第四个坑：颜色命名太具体。早期我用“蓝色”“红色”命名颜色令牌，后来换配色时发现名字和实际颜色对不上。后来改用“主色”“警示色”这种功能性命名，换配色时不需要改名字。

第五个坑：忘记导出矢量图。早期我只导出 PNG，后来需要放大打印时发现模糊了。后来所有图表都导出 SVG，矢量格式放大不模糊，而且文件更小。

6. 图表设计系统的扩展与维护

6.1 如何让团队接受一套图表规范

制定规范不难，难的是让团队接受并执行。我的经验是：不要一上来就推规范，而是先做几个示范案例，让大家看到规范带来的好处。

具体做法是：

1. 选一个大家公认“画得乱”的图，用规范重新设计一版。
2. 在评审会上对比新旧两版，让大家感受差异。
3. 把规范拆成“必选”和“可选”两部分。必选部分强制执行，可选部分自由发挥。
4. 提供模板和工具，降低执行成本。如果执行规范比不执行还麻烦，没人会执行。

实操心得：规范文档不要写太长，一页纸能说完最好。太长的文档没人看，看了也记不住。关键规则用加粗标出，示例用图展示。

6.2 图表设计系统的迭代节奏

图表设计系统不是一次性的项目，而是需要持续迭代的。我的迭代节奏是：

• 每月一次小迭代：修复 bug，调整参数，补充示例。
• 每季度一次中迭代：增加新的图类型，更新设计令牌。
• 每年一次大迭代：重新评估整体设计方向，考虑是否换工具或换方案。

迭代的输入来自三个方面：团队反馈、项目需求、行业趋势。团队反馈最直接，项目需求最紧迫，行业趋势最长远。三者要平衡，不能只盯着一个。

6.3 跨团队协作时的图表交付规范

当图表需要交付给其他团队使用时，交付物要包含以下内容：

• 源文件：可编辑的图表源文件，方便对方修改。
• 导出文件：SVG 和 PNG 两种格式，SVG 用于缩放，PNG 用于快速预览。
• 设计令牌：颜色、字号、间距的定义文件，方便对方保持一致。
• 使用说明：简短的说明文档，写清楚怎么修改、怎么导出、怎么反馈问题。

交付时我通常会附上一句话：“如果发现任何问题，直接提 issue，不要自己改源文件。”这样可以避免版本混乱。

6.4 图表设计系统的价值衡量

怎么判断一套图表设计系统是否成功？我通常看三个指标：

• 一致性：不同人画的图，风格是否一致。如果一眼能看出是同一套系统，说明成功。
• 效率：画一张图的时间是否缩短。如果从 30 分钟降到 10 分钟，说明成功。
• 可维护性：修改一张图是否容易。如果改一个节点不需要动其他节点，说明成功。

这三个指标不需要精确测量，凭感觉就能判断。如果团队里没人抱怨“图太难画”或“图太乱”，说明系统运转良好。

6.5 未来可能的扩展方向

图表设计系统还有很多可以扩展的方向。比如：

• 自动化生成：从代码注释或接口定义自动生成架构图。
• 交互式图表：点击节点展开详细信息，悬停显示注释。
• 多语言支持：同一张图支持中英文切换。
• 无障碍访问：为视障用户提供文字描述版本。

这些方向不一定都要做，但值得保持关注。图表设计的本质是信息传递，只要信息传递的效率还能提升，图表设计系统就有迭代的空间。

我个人在实际操作中的体会是，图表设计最难的不是技术，而是克制。克制住加颜色的冲动，克制住加节点的冲动，克制住加装饰的冲动。每加一个元素，都要问自己：这个元素帮助读者理解信息了吗？如果答案是否定的，就删掉。一张好的图，不是画得最多的图，而是删得最狠的图。