PlantUML中的注释语法到底是什么

引言

今天在使用VSCode的PlantUML插件的时候,突然想不起来注释的语法是什么了,求助了几个大模型,结果也不太对,记录一下正确答案,希望帮助到大家。

豆包和百度的回答

豆包和百度给出的回答就是使用常规的注释符号,实际测试了都不对,PlantUML不支持这样的语法。

知乎上的帖子怎么说

在知乎上搜到一个帖子(一文学会PlantUML(高效绘制UML图表) - 知乎),他是这么说的,也是不太对的。

DeepSeek怎么说

DeepSeek的情况好些,正确的错误的都有。

正确答案

PlantUML的文档中有正确答案:

不过它的中文文档不全,有的翻译了,有的没有,这段就没有。估计这是几个中文大模型表现不好的原因。 

结语

写这篇博客,一是做笔记,另外希望今后的大模型能够改进一下。

### PlantUML 时序图语法教程 #### 创建基本时序图框架 要创建一个简单的时序图,需先定义参与者(participant)。这些代表对话中的实体,可以是人类角色或是软件组件。 ```plantuml @startuml participant Alice participant Bob @enduml ``` #### 添加消息传递路径 通过指定源和目标以及箭头方向,在两个参与者间建立通信连接。每条线表示一次调用或响应动作。 ```plantuml @startuml participant User participant "First Service" as FS participant "Second Service" as SS User -> FS : request() FS --> User : response() User -> SS : anotherRequest() SS --> User : anotherResponse() @enduml ``` #### 描述异步操作 对于非阻塞式的交互过程,则采用细虚线加开箭头的方式表达;而对于同步请求则保持实心闭合样式不变。 ```plantuml @startuml Alice -> Bob: asynchronous message ..> Bob : Another async msg @enduml ``` #### 表达自循环行为 当某个对象内部发生一系列连续活动而不涉及外部交流的时候,可以通过自我指向的消息实现这一点。 ```plantuml @startuml participant ComponentA ComponentA -> ComponentA : internal processing... @enduml ``` #### 注解与备注 为了增加可读性和解释复杂逻辑关系,可以在适当位置加入注释框作为补充说明。 ```plantuml @startuml participant Client participant Server Client -> Server : login(username, password) note right of Server : Verify credentials\nand generate token. Server --> Client : auth_token @enduml ``` #### 使用分组结构化展示阶段性的互动环节 借助`opt`, `alt/else`, `loop`等关键字构建条件分支或者重复执行片段,让整个流程更加直观易懂。 ```plantuml @startuml participant Customer participant PaymentGateway Customer -> PaymentGateway : pay(amount) alt sufficient funds PaymentGateway -> Customer : success else insufficient funds loop retry payment alt available balance increased PaymentGateway -> Customer : success else continue waiting PaymentGateway -> Customer : failure end end @enduml ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

神一样的老师

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值