VSCode中PlantUML插件无法生成UML图，需依次检查插件启用状态、配置Graphviz路径、切换为本地Java渲染、确认文件关联与语法格式、手动触发预览导出。
如果您在VSCode中安装了PlantUML插件，但无法通过代码生成UML图，则可能是由于插件未正确配置、Graphviz未安装或PlantUML服务未启动。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、验证PlantUML插件安装与启用
确保VSCode中已安装并启用官方PlantUML插件（作者为jebbs），该插件负责解析.plantuml文件并调用渲染后端。若插件处于禁用状态或版本过旧，将无法触发图生成流程。
1、打开VSCode，点击左侧扩展图标（或按Cmd+Shift+X）。
2、在搜索框中输入PlantUML，确认结果中显示“PlantUML by jebbs”且状态为已启用。
3、若显示“已禁用”，点击右侧启用按钮；若未安装，点击安装并重启VSCode。
二、配置本地Graphviz渲染路径
PlantUML插件默认依赖Graphviz的dot命令进行图形布局计算。若系统未安装Graphviz或VSCode未识别其路径，会导致生成失败或仅输出文本。
1、在终端中执行dot -V，确认Graphviz已安装且版本不低于2.40。
2、若提示命令未找到，使用Homebrew安装：brew install graphviz。
3、打开VSCode设置（Cmd+,），搜索plantuml.java，找到“PlantUML: Graphviz Dot Path”选项。
4、将其值设为/opt/homebrew/bin/dot（Apple Silicon Mac）或/usr/local/bin/dot（Intel Mac）。
三、切换PlantUML后端为本地Java渲染
当网络不可用或在线服务不稳定时，可改用本地Java版PlantUML.jar进行离线渲染，避免依赖外部服务器。
1、下载最新plantuml.jar（从官网plantuml.com获取）并保存至本地目录，例如~/tools/plantuml.jar。
名扬银河企业建站系统，适用于无代码基础的新手，快速搭建企业网站，程序内置了多项实用功能及插件，能够便捷的对网站进行修改、调整、优化等方面进行操作。【部分功能介绍】1、产品管理发布企业产品信息，管理企业产品，自定义产品封面图，产品详情图、文、视频，产品扩展属性自定义等。2、案例管理系统发布企业成功案例，管理成功案例，自定义案例封面图，案例详情图、文、视频，案例扩展属性自定义等。3、资讯管理系统发布企
2、在VSCode设置中搜索“PlantUML: Server”，将“PlantUML: Server URL”留空。
3、搜索“PlantUML: Java Path”，设置为系统Java路径，如/opt/homebrew/opt/openjdk/bin/java。
4、搜索“PlantUML: Plantuml Jar”，设置为jar文件完整路径：~/tools/plantuml.jar。
四、检查文件关联与语法格式
VSCode需正确识别.plantuml或.puml后缀文件，并应用对应语言模式，否则编辑器不会激活PlantUML语法高亮与预览功能。
1、新建文件，保存为diagram.puml（推荐）或diagram.plantuml。
2、在文件顶部添加语言标识注释：@startuml，结尾必须有@enduml。
3、右下角状态栏确认语言模式显示为PlantUML；若显示为纯文本，点击该区域，选择“Configure file association for '.puml'” → “PlantUML”。
五、手动触发预览与导出
PlantUML插件不自动实时渲染，需主动调用命令以生成图表，尤其在配置变更后首次使用时必须手动触发。
1、打开.puml文件，确保光标位于图代码范围内（非空行或注释行）。
2、按下Cmd+Shift+P打开命令面板，输入PlantUML: Preview Diagram并回车。
3、若需导出为PNG，执行PlantUML: Export Current Diagram，选择目标格式与路径。
