notepad++不支持plantuml渲染的根本原因是缺少java运行环境和graphviz依赖，需安装jdk 8–17、graphviz并配置path，以管理员身份运行notepad++，手动指定plantuml.jar路径，且文件扩展名须为.puml或.plantuml。
Notepad++ 本身不支持 PlantUML 渲染，装了插件也出不来图——根本原因是缺少 Java 运行环境和 Graphviz 依赖，不是插件没装对。
PlantUML 插件安装后不显示预览窗口
这是最常见卡点：插件 PlantUMLViewer 或 PlantUML 安装成功，但右键菜单没有「Preview」，或点击后弹窗空白、报错 java.lang.ClassNotFoundException。
- 必须提前安装 JDK 8–17（推荐 JDK 11），且系统 PATH 中能调用
java -version - 必须单独安装
Graphviz（PlantUML 画流程图/时序图依赖它生成 SVG/PNG），下载地址是https://graphviz.org/download/，安装后把dot.exe所在目录（如C:\Program Files\Graphviz2.44\bin）加进系统 PATH - Notepad++ 需以管理员权限运行一次，否则插件可能无法写入临时渲染路径
- 插件设置里要手动指定
plantuml.jar路径（默认不自动识别），可去https://plantuml.com/download下载最新版 jar，填入插件配置页的JAR file path栏
写完 @startuml 后 Ctrl+Shift+P 没反应
快捷键失效通常不是绑定问题，而是当前文档语言模式未识别为 PlantUML。
- 确保文件扩展名是
.puml或.plantuml（Notepad++ 会据此加载语法高亮和插件上下文） - 若用
.txt或.md，需手动设置语言：菜单栏 →Language→P→PlantUML - 检查插件是否启用：菜单栏 →
Plugins→Plugin Manager→ 确认PlantUMLViewer勾选且状态为Loaded - 部分新版 Notepad++（v8.6+）与旧版 PlantUML 插件存在兼容问题，建议使用
PlantUMLViewer v1.3.1（GitHub release 页面可下载 DLL 文件手动放入plugins目录）
生成的图模糊、文字重叠、布局错乱
这不是渲染失败，而是 PlantUML 默认布局引擎受限于 Graphviz 的 dot 输出质量，尤其在复杂条件分支或长文本节点时明显。
- 在
@startuml后第一行加skinparam defaultFontSize 12和skinparam nodesep 20提升可读性 - 避免单行节点内容过长，用
\n换行（PlantUML 支持）：例如[用户登录\n验证Token] - 流程图优先用
flowchart TD（Top-Down），比LR更稳定；分支多时加autonumber辅助追踪逻辑流 - 如果仍错乱，导出为 SVG 而非 PNG：
Settings → PlantUMLViewer → Output format → SVG，SVG 在浏览器中缩放不失真
真正卡住的往往不是语法，而是 Java + Graphviz + 插件三者版本对不上。比如 JDK 21 不被 PlantUML 1.2023.x 支持，Graphviz 2.49 的 dot.exe 在 Win11 上可能需要关闭 Smartscreen 才能执行——这些细节不报错，只静默失败。
