如果您在VSCode中安装了PlantUML扩展，但无法正常渲染UML图，则可能是由于Graphviz未正确配置或Java环境缺失。以下是实现PlantUML图正常绘制的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并配置Java运行环境
PlantUML依赖Java虚拟机执行脚本解析，必须确保系统中已安装JDK且版本不低于11。未配置JAVA_HOME将导致插件启动失败。
1、访问Adoptium官网下载Temurin JDK 17 LTS版本安装包。
2、双击安装包完成图形化安装流程。
3、打开终端输入java -version验证安装结果，输出应包含"17"字样。
4、编辑~/.zshrc文件，在末尾添加一行：export JAVA_HOME=$(/usr/libexec/java_home -v17)。
5、执行source ~/.zshrc使环境变量立即生效。
二、安装Graphviz并配置PATH
PlantUML默认使用Graphviz的dot命令生成矢量图形，缺少该工具会导致时序图、组件图等布局异常或完全空白。
1、在终端中运行brew install graphviz（需提前安装Homebrew）。
2、执行dot -V确认输出包含版本号信息。
3、在VSCode设置中搜索“plantuml.graphvizPath”，点击编辑设置项。
4、将值设为/opt/homebrew/bin/dot（Apple Silicon芯片路径）或/usr/local/bin/dot（Intel芯片路径）。
三、配置VSCode PlantUML扩展参数
插件默认不启用实时预览，需手动开启服务模式并指定渲染后端，否则仅能导出图片而无法内联查看。
1、按下Cmd+Shift+P调出命令面板，输入并选择“PlantUML: Change Preview Server”。
2、在弹出选项中选择Jetty作为内置服务器。
3、再次调出命令面板，执行“PlantUML: Toggle Preview”以启动实时渲染窗口。
4、在settings.json中手动添加配置项："plantuml.render": "image"和"plantuml.exportFormat": "svg"。
四、创建并验证标准PlantUML文件结构
文件命名与头部声明不规范将导致语法识别失败，VSCode可能将其当作纯文本而非PlantUML源码处理。
1、新建文件，保存为diagram.puml（扩展名必须为.puml）。
2、在首行输入@startuml，末行输入@enduml。
3、在两行之间插入标准类图代码：class User {\n +String name\n +void login()\n}。
4、右键编辑器空白处，选择“PlantUML: Preview Current Diagram”。
5、确认右侧预览窗格中显示清晰的类图，且无红色波浪线报错。
