Mermaid类图语法增强：手动分隔属性与方法的设计探讨

在软件开发过程中，UML类图是表达系统设计的重要工具。作为流行的图表生成工具，Mermaid通过简洁的文本语法支持类图绘制。近期社区提出了一个关于类图语法的重要改进建议，值得开发者关注。

背景与现状

当前Mermaid的类图语法采用括号识别法来自动区分属性和方法：将带括号的识别为方法，不带括号的识别为属性。这种设计在大多数情况下工作良好，但在某些强类型语言场景下会出现边界情况。

以Crystal语言为例，其数组泛型语法使用Array(Int32)这样的表示方式。当这种类型声明出现在类属性中时，Mermaid会错误地将@radius : Array(Int32)识别为方法而非属性，因为解析器检测到了括号的存在。

建议核心内容

建议引入显式分隔符语法，允许用户通过水平线手动划分属性和方法区域。具体语法特征包括：

1. 使用至少3-4个连续的连字符(-)构成水平分隔线
2. 分隔线上方为属性声明区域
3. 分隔线下方为方法声明区域
4. 原有自动识别机制仍保留作为备选方案

示例语法：

classDiagram
class Circle {
    -@radius : Array(Int32)
    ----------------------------
    #initialize(radius : Array(Int32))
    +add_number(number : Int32) self
}

技术价值分析

这一改进带来多重优势：

1. 精确控制：彻底解决类型声明中包含括号导致的误判问题
2. 视觉清晰：分隔线提供更好的可读性，使类图结构一目了然
3. 语言兼容：更好地支持Crystal等使用特殊类型语法的语言
4. 渐进增强：不影响现有语法，保持向后兼容

实现考量

从实现角度看，语法解析器需要：

1. 优先检测分隔线存在性
2. 根据分隔线位置明确划分代码块
3. 在无分隔线时回退到原有解析逻辑
4. 确保行首的连字符序列不会被误认为注释或其它语法元素

扩展思考

这一语法改进也启发我们思考其他可能的优化方向：

1. 支持多级分隔（如按访问修饰符分组）
2. 允许自定义分隔符样式
3. 为分隔区域添加描述性标签
4. 结合IDE插件提供可视化编辑支持

结语

Mermaid作为文本化图表工具，其简洁性与表现力的平衡至关重要。这个建议既解决了具体的技术痛点，又保持了语法的优雅简洁，体现了工具设计中的实用主义哲学。对于使用强类型语言的开发团队，这一改进将显著提升类图绘制的准确性和效率。