文章介绍了架构图中常见的7个错误，旨在帮助读者避免这些误区，提升架构图的质量和可读性。内容来自Ilograph博客，主要面向技术架构师和设计师。

架构图中常见的七个错误

系统架构图是记录复杂系统的重要工具，但图中常见的错误可能导致读者困惑、误解甚至沮丧。本文列举了七个常见的架构图错误，并提供了改进建议。

1. 未标注资源名称

• 资源仅标注类型而未标注名称是常见问题
• 类型描述资源类别，名称则区分同类资源并揭示其作用
• 最佳做法是同时标注名称和类型（如"订单表"、"结果存储桶"）

2. 存在未连接资源

• 图中所有资源都应相互连接
• 未连接资源会让其作用变得不明确
• 通常是由于试图在单张图中包含过多信息所致

3. 制作"总览图"

• 试图用一张图展示整个系统通常是错误的
• 会导致信息过载，难以理解
• 解决方案是拆分为多个视角图，每个图讲述一个完整故事

4. 传送带综合征

• 行为图过度简化系统交互过程
• 将复杂交互简化为单向线性流程
• 应改用序列图来准确展示资源间的往返交互

5. 无意义的动画

• 社交媒体上常见花哨但无实质内容的动画
• 主要用于营销目的，技术价值低
• 除非是营销用途，否则应避免此类冗余动画

6. 扇形陷阱

• 当中间资源导致边缘资源间的关系信息丢失时发生
• 可通过在中间资源内添加更具体的子资源来解决
• 恢复边缘节点间的通信路径可见性

7. 依赖AI从源代码生成优质图

• AI目前生成的图常存在模糊、幻觉等问题
• 源于训练数据不足、分析密集代码困难等挑战
• 目前详细的系统制图仍需人工主导

作者建议，对于复杂系统，应避免制作"总览图"，而应采用多视角分解；行为图应使用序列图而非过度简化的流程图；同时要警惕AI自动生成图的局限性。

（注：本文保留了原文的技术要点和核心建议，删除了重复的导航菜单、社交媒体分享按钮等非主要内容，并对部分表述进行了符合中文习惯的优化。）

以下是评论内容的总结，平衡呈现不同观点并保留关键引用：

1. 图表真实性与实用性

   • 支持观点：真实但杂乱的图表比美观但失真的更有价值
     "A messy diagram that shows the real tradeoffs is more useful than a pretty one that lies" (ashwinnair99)
   • 反对观点：过度复杂的图表难以维护且实用性有限
     "I’ve seen more cases where they were clearly created to satisfy some exec...and never updated" (dawnerd)

2. 图表设计原则

   • 命名规范争议：
     "Don't encode types in names" (zabzonk)
   • 箭头含义需明确：
     "not agreeing on what arrows represent: control or data" (orthoxerox)
   • 抽象层级管理：
     "The business execs don't need the level of detail that someone debugging does" (datadrivenangel)

3. 受众与目的

   • 核心观点：图表需明确目标受众
     "The biggest mistake is not knowing your audience" (icedchai)
   • 开发者视角：
     "a diagram with links as table of contents is the answer" (dematz)
   • 非技术人员：
     "seeing data is believing...excel works best" (rawgabbit)

4. 技术实现争议

   • 工具局限性：
     "mermaid might render on github but not a text editor" (dematz)
   • AI时代质疑：
     "What a TERRIBLE way to store information in an AI era" (chrisss395)
   • 数据可视化优势：
     "high bandwidth way to show relationships...unreasonbly effective" (motohagiography)

5. 实践建议

   • 内容取舍：
     "It's never the right move to put All The Things in the chart" (drewbeck)
   • 创新形式：
     "put links in your diagram, so it functions as a table of contents" (dematz)
   • 美学要求：
     "If your diagram is ugly, you're probably mixing levels of abstraction" (motohagiography)