如何在PlantUML图中使用YAML数据？现有代码故障排查

你的代码无法运行主要有几个核心问题：

• PlantUML原生不支持直接解析YAML格式的!define变量，你定义的YAML_DATA只是普通字符串，{%YAML_DATA.actor%}这种语法完全不被识别
• 就算能解析YAML，PlantUML预处理器也不支持{%YAML_DATA.usecases.name%}这种批量提取数组元素的路径语法
• 循环外的%ACTOR_NAME% -> %uc%中，%uc%是循环内的局部变量，循环外不存在这个变量，会报错

修正后的可行代码 #

PlantUML没有原生YAML解析功能，但可以用预处理器函数模拟结构化数据的读取，替代YAML的作用：

!function getActor()
  !return "User"
!endfunction

!function getUseCaseCount()
  !return 2
!endfunction

!function getUseCase($index)
  !if ($index == 0)
    !return "Browse Products"
  !elseif ($index == 1)
    !return "Purchase Product"
  !endif
!endfunction

@startuml
!define ACTOR_NAME getActor()

actor ACTOR_NAME

%for %i in 0 to getUseCaseCount()-1%
  !define UC_NAME getUseCase(%i)
  usecase UC_NAME
  ACTOR_NAME -> UC_NAME
%endfor%

@enduml

关键说明 #

1. 用函数模拟结构化数据：通过自定义函数返回单个字段或列表元素，替代YAML的结构化存储
2. 循环语法正确使用：PlantUML预处理器的%for%循环支持数字范围遍历，通过索引获取每个用例
3. 变量作用域修正：在循环内定义局部变量UC_NAME，并直接在循环内完成角色与用例的关联，避免循环外变量不存在的问题

如果需要更接近YAML的写法，也可以借助第三方扩展（如plantuml-yaml）实现外部YAML文件引入，但原生PlantUML不支持该功能，所以用自定义函数是最稳妥的原生方案。

内容的提问来源于stack exchange，提问作者Clinton Jones