C4-PlantUML中边界(Boundary)元素命名的注意事项

在使用C4-PlantUML进行架构图绘制时，边界(Boundary)元素的命名需要特别注意一个关键细节：元素的别名(alias)中不能包含空格。这一细节虽然简单，但容易导致样式渲染不正确的问题。

问题现象

当开发者尝试创建一个名为"Base Query"的边界元素时，虽然语法上没有报错，但元素的样式（如颜色、边框等）无法正确渲染。这是因为在C4-PlantUML中，元素的别名(alias)部分不能包含空格字符。

正确做法

正确的做法是将边界元素的别名改为不含空格的格式，例如"BaseQuery"。同时，在定义边界样式时，应使用$borderStyle参数而非$lineStyle来设置边框样式。

样式定义建议

在C4-PlantUML中定义元素样式时，可以通过AddElementTag和AddRelTag等指令来创建自定义样式。对于边界元素，建议：

1. 使用简洁且不含空格的别名
2. 通过$borderStyle而非$lineStyle来定义边框样式
3. 可以结合$bgColor、$fontColor等参数创建丰富的视觉效果

实际应用示例

Boundary("BaseQuery", "Base Query") {
    WithoutPropertyHeader()
    Container(container1, "容器1", "技术类型")
    WithoutPropertyHeader()
    Container(container2, "容器2", "技术类型")
}

通过遵循这些命名规则和样式定义方法，可以确保C4架构图中的边界元素能够正确渲染，并获得预期的视觉效果。这对于创建专业、清晰的架构图至关重要。