C4-PlantUML 中文字重叠问题的分析与解决方案

在使用 C4-PlantUML 绘制架构图时，用户可能会遇到容器内文字重叠的问题。这个问题主要源于字体支持不足导致的渲染差异。

问题现象

当在 draw.io 中使用 C4-PlantUML 绘制架构图时，容器内的文字可能会出现重叠现象。这种情况在 SVG 格式的输出中尤为明显，而 PNG 格式则表现正常。这种差异源于两种格式使用了不同的字体渲染机制。

根本原因分析

经过深入调查，发现问题的核心在于 draw.io 内置的 PlantUML 服务器/插件仅支持有限的字体。具体表现为：

1. SVG 和 PNG 输出使用了不同的字体渲染方式
2. 内置 PlantUML 服务器仅安装了一种基本字体
3. 字体度量计算不准确导致文字布局错误

解决方案

针对这一问题，我们提供以下解决方案：

临时解决方案

1. 使用 PNG 格式输出：虽然这不是完美的解决方案，但可以暂时避免文字重叠问题
2. 简化文字内容：减少容器内的文字量或调整换行位置

长期解决方案

1. 搭建私有 PlantUML 服务器：通过 Docker 部署自己的 PlantUML 服务器
2. 安装额外字体：在私有服务器上安装所需字体，确保渲染一致性

技术实现细节

对于需要搭建私有服务器的用户，可以参考以下步骤：

1. 使用官方 PlantUML Docker 镜像部署服务
2. 在容器中安装所需字体文件
3. 配置 draw.io 使用自定义的 PlantUML 服务器地址

这种方法不仅能解决字体问题，还能提供更灵活的定制选项，满足企业级应用的需求。

总结

C4-PlantUML 的文字重叠问题本质上是字体支持不足导致的渲染差异。通过理解问题的根源并采取适当的解决方案，用户可以确保架构图的清晰展示。对于企业用户，建议采用私有化部署方案以获得最佳效果和最大灵活性。