知识卡片
图例价值与箭头语义歧义
内容
图例不只是符号对照表：一个丰富的图例能直接传达设计者对抽象的思考（如为何用圆角矩形表示组件），而简陋图例只是走过场。反直觉建议：不要在连接器上画箭头，因为一个箭头无法同时表达”谁发起连接”“谁服务于连接”“数据流主方向”等多个不同属性，读者常自以为懂箭头含义却猜错；若确实要用箭头，必须在图例中写清楚它具体表示什么。
参考来源
- 位置：《恰如其分的软件架构》第15章《使用架构模型》15.4.1节《在图上加图例》、15.4.2节《不要画连接器上的箭头》（源文件：_epub-src/OEBPS/text00163.html）
- 结论依据：原文对比图15.1两种图例的差异说明丰富图例能传达设计思考，并解释箭头因需同时表达多种不同属性而语义模糊、读者常误读，建议避免使用或必须在图例中明确定义。
- 原始内容：右边的那个，即使不看图，也能通过它对架构有所了解。……最糟糕的是，读者总是以为他们知道图中箭头的含义，但他们很可能猜错了。……然而，如果使用了箭头，就应该在图例中表达出箭头的含义。