PlantUML中带长描述的节点同时添加嵌套组件时报错如何解决？

问题原因 #

PlantUML 语法本身不支持节点同时使用 [] 包裹长描述、以及 {} 定义嵌套子元素两种语法，两者直接连用会触发解析器报错，属于原生设计限制。

解决方法 #

将长描述内容移动到节点类型后的多行双引号块中，配合 as 关键字绑定节点ID，再在后面接嵌套结构即可正常解析，示例代码如下：

node "
<<device>>
--
long description here
" as mynode {
    artifact "a nested element"
}

如果长描述是单行内容，也可以简化为更紧凑的写法：

node mynode <<device>> "single line description" {
    artifact "a nested element"
}

内容的提问来源于stack exchange，提问作者Fabrizio Stellato