应将 plantuml.render 设为 PlantUMLServer，并清除所有本地路径配置（如 plantuml.java、plantuml.dot 等），重启 VSCode 后即可正常渲染；类图需严格遵循可见性符号、大括号及无空行等语法；导出推荐 SVG 格式并设 exportScale 为 2 提升清晰度。
能直接画，不用装Java或Graphviz也能跑起来——关键是选对渲染方式和插件配置。
为什么按教程装完还是报错 dot not found
绝大多数报错都卡在本地渲染路径上。新版 PlantUML 插件（jebbs 版）默认启用远程服务器渲染，但如果你之前手动配过 plantuml.jar 或 GRAPHVIZ_DOT，残留配置会强制它走本地流程，而此时 dot 命令又不在 PATH 里，就直接崩出这个错误。
- 打开 VSCode 设置（
Ctrl+,），搜索plantuml.render，确认值是PlantUMLServer（不是Local） - 删掉
settings.json中所有以plantuml.java、plantuml.dot、GRAPHVIZ_DOT开头的配置项 - 重启 VSCode，新建一个
test.puml，输入最简代码：@startuml A --> B @enduml
再按Alt+D，应该立刻出图
类图里字段和方法不显示？检查修饰符和大括号语法
PlantUML 类图不会自动推导成员——你写什么，它才画什么。漏掉大括号、用错符号、或者没加可见性前缀，都会导致字段/方法“消失”。
- 类定义必须带大括号：
class User { }，光写class User不会渲染任何成员 - 每个字段或方法前必须加可见性符号：
+name: String、-id: int、#age: int，不加就当注释忽略 - 字段和方法之间不能空行（PlantUML 解析器会截断）；若需分组，用空格或注释隔开，别换行
- 如果用了
{abstract}或{interface}等关键字，确保它紧贴在类名后，且前后有空格：abstract class Service { }
导出 PNG/SVG 总是模糊或裁切？改这两个配置项
默认导出用的是低分辨率位图，且不自动适配图表尺寸，尤其对时序图、部署图这类宽高比特殊的图，容易切掉边缘或文字糊成一片。
- 在
settings.json中加这两行："plantuml.exportFormat": "svg", "plantuml.exportScale": 2
-
exportFormat设为svg可彻底解决模糊问题，矢量图缩放无损 -
exportScale控制 PNG 导出倍率（仅对 PNG 生效），设为2能显著提升清晰度，但文件体积略增 - 导出前先用
Alt+D预览，拖动预览窗口右下角调整缩放比例，确认全图可见再导出
真正麻烦的不是语法，而是渲染链路里那些隐式开关：一个配置项关着，整个流程就退回到本地模式；一个空格少打，类成员就全没了。画图快慢，八成取决于你有没有在第一次报错时就去翻 plantuml.render 的值。
