UD5工具箱
什么是 PlantUML 编码？它的工作原理是什么？
PlantUML 编码是将 PlantUML 文本代码转换为可嵌入 URL 链接的过程。其工作原理分为两步：首先使用 Deflate 压缩算法（Raw Deflate）对原始文本进行无损压缩，然后使用 PlantUML 专用的自定义 Base64 字符集对压缩后的二进制数据进行编码。编码后的字符串附加到 PlantUML 渲染服务器 URL 后面，通过 HTTP 请求即可获取渲染后的图表图片。本工具自动完成这两个步骤，用户只需点击编码按钮即可获得完整的图表链接。
为什么需要使用 PlantUML 编码解码工具？
在许多平台中直接嵌入 PlantUML 图表需要使用编码后的 URL 链接。例如 GitHub README、Confluence 页面、Notion 文档等都支持通过 Markdown 图片语法或 HTML img 标签引用 PlantUML 渲染服务器生成的图片。本工具帮助你快速将 PlantUML 代码转为可分享的链接，也可以从已有链接中还原原始代码进行修改。此外，工具支持 PNG、SVG、ASCII 等多种输出格式，满足不同平台的使用需求。
编码后的字符串可以直接手动修改吗？
不建议直接修改编码后的字符串。编码字符串是经过 Deflate 压缩和 Base64 编码后的二进制数据，任何手动修改（哪怕是增加或删除一个字符）都会破坏数据完整性，导致解码失败或图表渲染异常。如果需要修改图表内容，请使用本工具的解码功能将编码字符串还原为原始 PlantUML 代码，在代码层面进行修改后重新编码生成新的链接。
支持哪些 PlantUML 图表类型？
本工具的编码解码功能不限制图表类型，支持 PlantUML 能够渲染的所有图表格式。这包括但不限于：类图（Class Diagram）、时序图（Sequence Diagram）、用例图（Use Case Diagram）、活动图（Activity Diagram）、组件图（Component Diagram）、状态图（State Diagram）、对象图（Object Diagram）、部署图（Deployment Diagram）、定时图（Timing Diagram）等。工具内置了类图、时序图、用例图、活动图和组件图五种快速示例，帮助用户快速上手。
PlantUML 服务器有哪些选择？各自有什么优缺点？
本工具提供三种服务器选项：官方服务器（plantuml.com）由 PlantUML 项目团队维护，渲染质量最稳定，但在部分地区可能存在访问速度较慢的问题；备用镜像（blue-dot.net）是社区维护的镜像服务器，适合官方服务器访问受限的地区使用；自定义服务器允许用户输入自己部署的 PlantUML 服务地址，适合企业内部使用 Docker 部署的私有渲染实例。你可以根据网络环境和使用场景灵活选择最合适的服务器。
预览图片为什么显示不出来？如何解决？
预览图片无法显示通常有以下原因：第一，PlantUML 渲染服务器连接超时或不可用，可以尝试切换到其他服务器选项；第二，PlantUML 代码存在语法错误，服务器会返回错误图片或空响应，建议检查代码语法的正确性；第三，浏览器跨域安全策略限制，某些浏览器可能会阻止跨域图片请求。解决方法包括切换服务器、检查代码语法、刷新页面重试，或使用浏览器开发者工具的网络面板查看具体的请求错误信息。
在哪些平台中可以使用生成的 PlantUML 链接？
生成的 PlantUML 链接可以在任何支持外部图片引用的平台中使用。常见平台包括：GitHub（在 Markdown 文件中使用图片语法）、GitLab、Confluence、Notion、各类博客平台（如 Hugo、Hexo）、企业 Wiki 系统、技术文档站点等。使用方式通常是在 Markdown 中写入  或在 HTML 中使用 img 标签引用链接。部分 IDE 插件（如 VS Code 的 PlantUML 插件）也可以直接使用这些链接进行实时预览。
这个工具是免费的吗？数据是否安全？
本工具完全免费使用，没有任何使用次数或功能限制。在数据安全方面，所有编码和解码操作均在浏览器本地 JavaScript 中完成，你的 PlantUML 源代码和编码字符串不会被上传到任何远程服务器。只有在生成图表预览时才会向所选的 PlantUML 渲染服务器发送 HTTP 请求，且该请求仅包含编码后的数据，不涉及任何原始代码或个人信息。你可以放心在工具中处理包含敏感架构设计的 PlantUML 代码。
PlantUML 代码的基本语法结构是什么样的？
PlantUML 代码的基本结构是以 @startuml 开头，以 @enduml 结尾，中间使用特定语法描述图表内容。例如在类图中使用 class ClassName { } 定义类，使用 ClassA -- ClassB 定义类之间的关系；在时序图中使用 participant 定义参与者，使用箭头表示消息传递。本工具提供了五种常用图表类型的快速示例，点击即可加载示例代码，帮助你直观理解每种图表的语法结构。你也可以访问 PlantUML 官方文档查看完整的语法参考。